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CHAPTER  1 

COASTAL  MODELING  SYSTEM  (CMS)  OVERVIEW 

PART  I :  INTRODUCTION 

Background 

1.  Numerical  modeling  technology  is  increasingly  being  employed  as  a 
tool  to  study  complex  problems  in  many  engineering  disciplines.  In  the  field 
of  coastal  engineering,  processes  studied  with  numerical  models  include: 
hydrodynamics  and  transport  associated  with  astronomical  tides,  storm  surges, 
and  tsunamis;  refraction,  diffraction,  shoaling  and  breaking  of  waves;  wave- 
induced  currents;  shoreline  change  induced  by  littoral  movement  of  sand; 
erosion  caused  by  short-term  severe  storms;  and  the  fate  and  stability  of 
dredged  material  placed  in  open  water. 

2.  Numerical  models  use  sophisticated  methodology  to  solve  governing 
equations  describing  the  physical  processes  of  interest.  When  a  physical 
process  is  well  described  by  the  specified  equations,  the  numerical  modeling 
technique  is  capable  of  providing  accurate  solutions  to  engineering  problems. 
However,  the  model  developer  must  take  extreme  care  in  implementing  the 
equations  in  a  numerical  scheme,  and  the  model  must  be  thoroughly  tested  for  a 
variety  of  conditions  and  compared  with  prototype  measurements  to  ensure 
correct  model  operation.  Of  equal  importance  is  the  care  the  engineer  must 
take  in  applying  the  model  to  a  field  problem  by  ensuring  that  the  model's 
governing  equations  are  appropriate  for  representing  the  dominant  physical 
processes  at  the  site.  Also,  errors  in  input  specification  could  dramatically 
alter  model  results,  and  without  diligent  inspection  of  model  output,  the 
errors  could  go  undetected. 

3.  The  Coastal  Engineering  Research  Center  (CERC)  has  developed  a 
number  of  numerical  models  that  are  used  for  studying  a  variety  of  coastal 
processes  under  existing  and  proposed  configurations.  Some  of  these  models 
are  large  and  complex  and  may  require  a  substantial  amount  of  input  data 
and/or  computing  effort.  The  models  usually  have  a  battery  of  supporting 
software  for  creating  computational  grids,  running  the  model  on  the  host 
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computer,  and  evaluating  large  amounts  of  output  from  the  simulations. 

Because  of  the  complexity  of  the  model  software  and  the  diversity  of 
modifications  to  input  data  associated  with  individual  applications,  these 
models  have  required  considerable  effort  to  apply. 

4.  Traditionally,  most  of  the  models  were  developed  by  researchers  as 
individual  efforts  to  solve  a  specific  problem.  Consequently,  models  have 
used  different  input/output  structures,  have  been  sparsely  documented,  and 
have  been  frequently  altered  to  accomplish  application-specific  tasks.  In 
addition,  each  model  had  its  own  set  of  supporting  utilities  to  plot  results, 
reformat  data,  etc.  Often  code  alterations  resulted  in  several  versions  of 
the  same  model,  each  with  specific  or  enhanced  capabilities.  This  situation 
had  the  potential  for  introducing  errors,  either  by  engineers  applying  the 
wrong  version  of  the  model  or  by  programmers  inadvertently  altering  the 
operation  of  a  previously  tested  portion  of  the  model. 

5.  Because  of  these  factors,  some  of  the  most  useful  models  at  CERC 
have  also  been  the  most  difficult  to  apply;  and  in  some  cases,  it  was  neces¬ 
sary  for  the  model  developer  to  oversee  the  specific  application.  This 
dependence  on  the  model  developer  meant  that  he  or  she  had  less  time  to  devote 
to  providing  improved  models  to  solve  Corps  problems. 

6.  The  condition  of  the  models  described  above  implied  a  need  for: 

a.  Maintenance  of  a  single  version  of  each  model. 

b.  Standardization  of  the  model  input/output  processes. 

c.  A  central  location  for  using  the  models. 

d.  Versatile  models  capable  of  covering  a  wide  range  of  problems 
at  different  sites  by  using  model  options. 

e.  Comprehensive  model  documentation  in  the  form  of  a  user's 
manual . 

Objective 

7.  The  Coastal  Modeling  System  (CMS)  is  a  software  package  aimed  at 
organizing  CERC's  larger  numerical  models  and  their  supporting  software  into  a 
user-friendly  system  that  is  available  to  all  Corps  elements  having  a  need  to 
apply  the  supported  modeling  technology. 

8.  Several  objectives  are  followed  in  developing  and  expanding  CMS. 
Since  some  of  the  models  share  similar  input  requirements,  output  capability, 
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and  procedural  implementation,  efforts  are  made  to  standardize  these  portions 
of  the  models  as  much  as  possible.  This  standardization  promotes  efficiency 
because  coding  effort  is  reduced,  new  users  learn  the  models  in  the  system 
more  rapidly,  and  chances  for  errors  in  entering  input  or  interpreting  output 
are  reduced  because  of  user  familiarity  with  the  system  structure. 

9.  Most  numerical  models  are  applied  to  specific  areas  by  representing 
the  spatial  bathymetric  and  topographic  features  as  depths  or  elevations  on  a 
matrix  called  a  computational  grid.  In  some  instances,  it  is  possible  to 
share  a  common  numerical  grid  between  models.  This  commonality  allows 
efficient  application  of  several  different  models  to  the  same  site  without 
additional  effort  in  building  new  grids.  Similarly,  processing  of  model 
output  data  can  proceed  in  the  same  manner  for  several  different  models .  To 
the  extent  possible,  models  in  CMS  share  the  same  numerical  grids,  utilities, 
plotting  programs,  post-processing  routines,  and  job  control  files. 

10.  FORTRAN  77  programming  language  is  used  exclusively  in  the  system 
software  to  ensure  portability  of  the  models  and  supporting  programs  to  other 
computer  systems.  Graphics  programs  also  make  use  of  DISSPLA™  software.  When 
appropriate,  attempts  are  made  to  produce  a  code  that  is  capable  of  being 
vectorized  for  efficient  and  economical  use  on  vector  array  processing 
computers  such  as  the  CRAY  Y-MP,  where  CMS  resides. 

11.  Models  selected  for  inclusion  in  CMS  must  be  well  advanced  in  their 
development,  and  they  must  have  been  rigorously  tested  over  a  wide  range  of 
conditions.  In  most  cases,  a  selected  model  has  already  been  applied  to 
numerous  field  problems  and,  thus,  has  reached  some  level  of  maturity  through 
careful  application  to  the  types  of  problems  encountered  by  the  Corps. 
Incorporation  of  these  time- tested  models  into  CMS  involves  modification  to 
the  input/output  structure  and,  possibly,  re-coding  of  sections  to  produce 
more  efficient  use  of  computer  resources.  Once  included  in  CMS,  the  models 
are  not  expected  to  be  modified  unless  errors  are  found  or  new  features  are 
added.  Therefore,  the  models  in  CMS  can  be  considered  tested,  reliable,  and 
mature . 
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PART  II:  IMPLEMENTATION  OF  CMS 

Organization 

12.  CMS  software  is  organized  into  three  major  groups:  models, 

supporting  utilities,  and  procedure  files  that  draw  components  together  for 
execution.  Several  software  elements  use  common  algorithms,  and  efforts  are 
made  to  place  these  software  elements  into  shared  libraries.  This  placement 
eliminates  redundant  software  and  reduces  associated  development  costs. 

13.  Another  level  of  organization  concerns  user  interfaces  to  the 
software,  which  are  arranged  according  to  various  activities  encountered 
during  a  modeling  endeavor.  These  major  procedure  files  provide  users  access 
to  the  various  CMS  software  elements  on  the  available  computers . 

14.  Although  the  models  and  supporting  software  are  written  in  standard 
FORTRAN  77,  library  structures  and  procedure  files  are  specific  to  the 
computer  system  hosting  CMS.  In  addition,  some  plotting  utilities  rely  on 
specific  graphics  software  that  resides  on  the  host  computer,  and  certain 
terminal/plotter  configurations  may  be  required  to  produce  plots  of  the  model 
output  at  the  user's  local  site. 

Host  Computer  System 

15.  Most  models  included  in  CMS,  or  targeted  for  addition  to  CMS,  are 
both  memory- intensive  and  computationally  intensive,  requiring  use  of  large 
supercomputers  for  efficient  operation.  It  is  possible  to  run  some  of  the 
models  on  smaller  minicomputers,  but  double  precision  would  probably  be 
necessary  to  avoid  accumulated  round-off  errors,  and  applications  could  take 
from  several  hours  to  several  days  of  CPU  time  on  the  smaller  machines. 

16.  To  satisfy  the  objective  of  Corps -wide  access  to  the  models, 
initial  installation  of  CMS  was  on  a  mainframe  computer  operated  by  Scientific 
Information  Services  (SIS),  formerly  CYBERNET,  which  provided  Corps-wide 
mainframe  and  supercomputer  service.  Now,  with  the  installation  of  a  CRAY  Y- 
MP  at  the  US  Army  Engineer  Waterways  Experiment  Station  (WES),  Corps-wide 
access  is  available,  and  CMS  has  been  transferred  to  that  system  to  take 
advantage  of  reduced  costs  and  the  likelihood  of  a  permanent  home  for  CMS. 
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17.  Corps  personnel  have  access  to  the  CRAY  Y-MP  through  several 
communication  networks.  Presently,  the  supercomputer  can  be  accessed  through 
INTERNET,  MILNET,  ARPANET,  ASNET ,  SURANET,  BITNET,  NSFNET,  through  a  1200, 
2400,  or  9600  baud  modem,  dedicated  line,  or  the  "front  end"  VAX  8800 
computer. 

18.  Generally,  CMS  users  are  not  required  to  learn  the  operating  system 
associated  with  the  supercomputer  (UNIC0S)  because  most  of  the  job  control 
commands  normally  required  to  submit  models  and  data  files  to  the  computer  for 
execution  are  accomplished  by  the  CMS  procedure  files.  This  setup  reduces 
learning  time  appreciably  and  minimizes  errors  caused  by  improper  commands. 
However,  users  must  be  able  to  manipulate  files,  create  and  edit  ASCII  files, 
and  download  output  files  to  a  printer  or  plotter.  These  functions  are  easily 
mastered,  and  manuals  are  available  to  all  Corps  users  of  the  CRAY  Y-MP  at  a 
nominal  fee  by  contacting  the  Information  Technology  Laboratory  (ITL)  Research 
Library,  Ms.  Susan  Hicks  (601)  634-2296.  Presently  there  are  26  CRAY  manuals 
covering  such  topics  as  UNICOS  User  Commands,  CFT77  Reference,  UNICOS  Support 
Tools,  and  UNICOS  Symbolic  Debugging. 

Model  Support 

19.  Including  a  model  In  CMS  represents  a  technology  transfer  from  CERC 
to  the  field.  CERC  will  maintain  the  CMS  on  the  WES  CRAY  Y-MP  and  will 
provide  support  services  to  Corps  users  of  the  system.  Support  includes 
correcting  recognized  flaws  in  the  codes,  updating  the  models  with  new 
capabilities  and  technology,  improving  the  user  interface  to  the  models, 
improving  graphics  and  visualization  capabilities,  updating  the  User's  Manual 
to  reflect  changes  to  the  models  and/or  CMS,  conducting  periodic  workshops  for 
Corps  personnel,  and  providing  telephone  support  services. 

20.  Additionally,  CERC  staff  can  assist  Corps  personnel  in  applications 
of  the  CMS  via  "one-stop  services"  or  by  direct  participation  in  site-specific 
studies.  One-stop  service  is  intended  to  address  questions  or  problems  that 
arise  during  field  application  of  a  model  in  CMS.  Usually,  these  questions 
can  be  satisfactorily  resolved  In  a  short  time  over  the  telephone.  More 
involved  questions  requiring  a  substantial  effort  by  CERC  engineers  or 
scientists  may  require  reimbursement.  Experience  at  CERC  indicates  that  field 


1-5 


application  of  these  models  usually  requires  a  significant  initial  consulting 
effort  by  CERC  engineers  until  experience  has  been  gained  by  the  field  user. 


Coastal  Modeling  System  (CHS)  User's  Manual 

21.  The  Coastal  Modeling  System  (CMS)  User’s  Manual  is  intended  to  be 
an  evolving  document,  and  it  is  structured  in  a  modular  fashion,  much  like  the 
modeling  system  itself.  Individual  numerical  models  and  major  supporting 
utility  software  are  documented  in  separate  chapters.  Attempts  are  made  to 
structure  all  chapters  in  a  similar  format  to  facilitate  learning  the  system 
models . 

22.  The  unbound  format  of  the  user's  manual  allows  efficient  and  cost- 
effective  updating  of  the  manual  as  models  are  added  to  CMS,  and  it  allows 
users  to  remove  chapters  for  convenient  reference  during  model  applications . 
The  documentation  for  each  new  model  will  be  an  added  chapter  to  the  CMS 
User's  Manual.  Updates  will  also  include  additions  of  (or  alterations  to) 
utilities  and  procedures. 

23.  Initial  distribution  of  the  CMS  User's  Manual  will  be  to  all  Corps 
Divisions  and  Districts  with  coastal  interests.  A  register  of  all  manuals 
distributed  within  the  Corps  of  Engineers  will  be  maintained  by  CERC,  and 
updates  will  be  provided  for  all  Corps -registered  copies  of  the  manual. 

24.  Training  on  the  usage  of  CMS  and  on  application  of  specific  models 
within  CMS  is  accomplished  during  periodic  workshops.  Workshop  participants, 
especially  new  users,  will  be  introduced  to  CMS.  Each  workshop  will  demon¬ 
strate  sign-on  procedures,  building  input  data  files,  file  transfer  methods, 
accessing  CMS,  running  workshop -specific  models,  and  post-processing  model 
results.  Technical  presentations  of  workshop  specific  models  will  also  be 
given.  More  intensive  training  can  be  provided  at  CERC  as  part  of  joint  field 
applications  between  CERC  and  personnel  from  a  field  activity. 

Point  of  Contact 

25.  Each  model  residing  in  CMS  has  a  CERC  point  of  contact  (POC).  Most 
often  that  person  is  the  model  developer  or  someone  with  extensive  experience 
in  applying  the  model.  Table  1-1  provides  POC's  for  models  presently  included 
in  CMS.  This  table  will  be  updated  periodically  to  assure  that  it  continues 


1-6 


to  be  a  useful  reference  for  CMS  users.  The  aodules  listed  in  column  1  of 
Table  1-1  are  briefly  described  in  Part  III  of  this  chapter  and  are  extensive¬ 
ly  documented  in  later  chapters. 


Table  1-1 


Phone  Number 


CMS  general 
inquiries 

Ms. 

Mary  A. 

Cialone 

CEWES-CR-P 

601-634-2139 

Using  CMS 

Ms. 

Lucy  W. 

Chou 

CEWES-CR-P 

601-634-2843 

SPH 

Mr. 

Dave  J . 

Mark 

CEWES-CR-P 

601-634-2094 

WIFM 

Ms. 

Mary  A. 

Cialone 

CEWES-CR-P 

601-634-2139 

RCPWAVE 

Ms. 

Mary  A. 

Cialone 

CEWES-CR-P 

601-634-2139 

CLHYD 

Ms. 

Mary  A. 

Cialone 

CEWES-CR-P 

601-634-2139 

SHALWV 

Dr. 

Robert 

E.  Jensen 

CEWES-CR-0 

601-634-2101 

CMSGRID 

Ms. 

Mary  A. 

Cialone 

CEWES-CR-P 

601-634-2139 

CMSUTIL 

Ms. 

Lucy  W. 

Chou 

CEWES-CR-P 

601-634-2843 

CMSPOST 

Ms. 

Lucy  W. 

Chou 

CEWES-CR-P 

601-634-2843 

PART  III:  PRESENT  CMS  COMPONENTS 


26.  The  following  briefly  describes  the  numerical  models,  major  utility 
software,  and  major  procedures  currently  in  the  Coastal  Modeling  System. 


27.  This  chapter  provides  information  on  execution  of  the  CMS  on  the 
WES  CRAY  Y-MP.  The  new  user  should  refer  to  this  chapter  to  learn  to  compile 
or  run  a  model  for  a  specific  application.  Once  the  user  becomes  familiar 
with  the  system,  this  chapter  can  be  used  as  a  quick  reference. 


28.  The  numerical  model  SPH  is  a  parametric  model  for  representing  wind 
and  atmospheric  pressure  fields  generated  by  hurricanes.  It  is  based  on  the 
Standard  Project  Hurricane  criteria  developed  by  the  National  Oceanic  and 
Atmospheric  Administration  (NOAA  1979),  and  the  model's  primary  output  are 
hurricane -generated  wind  fields  that  can  be  used  in  storm  surge  modeling.  It 
can  be  run  separately,  or  it  can  be  invoked  from  within  the  WES  Implicit 
Flooding  Model  (WIFM) . 


29.  The  numerical  model  WIFM  solves  the  vertically  integrated  Navier- 
Stokes  equations  in  stretched  Cartesian  coordinates.  The  model  simulates 
shallow-water,  long-wave  hydrodynamics  such  as  tidal  circulation,  storm 
surges,  and  tsunami  propagation.  WIFM  contains  may  useful  features  for 
studying  these  phenomena,  such  as  moving  boundaries  to  simulate  flooding/ 
drying  of  low-lying  areas  and  subgrid  flow  boundaries  to  simulate  small 
barrier  islands,  jetties,  dunes,  or  other  structural  features.  The  model  may 
be  driven  at  the  outer  boundary  by  tide  elevations,  flow  velocities,  specifi¬ 
cation  of  uniform  flux,  or  inverted  barometer  effects.  WIFM  also  accepts  wind 
fields  for  including  the  effects  of  wind  stress  during  hurricanes  or  other 
strong  storm  systems. 
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30.  The  numerical  model  RCPWAVE  is  a  short-wave  model  used  to  predict 
linear,  plane  wave  propagation  over  an  open  coast  region  of  arbitrary  bathyme 
try.  RCPWAVE  uses  linear  wave  theory  because  it  has  been  shown  to  yield 
fairly  accurate  first-order  solutions  to  wave  propagation  problems  at  a 
relatively  low  cost.  Refractive  and  bottom- induced  diffractive  effects  are 
included  in  the  model;  however,  the  model  cannot  treat  diffraction  caused  by 
surface-piercing  structures.  This  model  does  not  include  nonlinear  wave 
effects  or  a  spectral  representation  of  irregular  waves. 


Chapter  6:  Curvilinear  Long-Wave  Hydrodynamic  Model  (CLHYD) 


31.  Numerical  model  CLHYD  simulates  shallow-water ,  long-wave  hydrody¬ 
namics  such  as  tidal  circulation  and  storm  surge  propagation.  CLHYD  can 
simulate  flow  fields  induced  by  wind  fields,  river  inflows/outflows,  and  tidal 
forcing.  CLHYD  is  similar  to  WIFM,  with  the  added  feature  of  operating  on  a 
boundary- fitted  (curvilinear)  grid  system.  However,  CLHYD  cannot  simulate 
flooding/drying  of  low-lying  areas  as  WIFM  can.  This  feature  will  be  incorpo¬ 
rated  in  a  later  release  of  CLHYD. 


Chapter  7:  Spectral  Wave  Modeling  Module  of  CMS  (SHALWV) 


32.  The  numerical  model  SHALWV  is  a  time-dependent  spectral  wind-wave 
model  for  computing  a  time -history  of  wind- generated  waves.  The  model  solves 
the  inhomogeneous  energy  balance  equation  using  finite  difference  methods.  It 
simulates  the  growth,  decay,  and  transformation  of  a  wave  field  over  a  spatial 
area  (i.e.,  an  ocean  basin,  bay,  or  lake)  for  a  given  time  period.  SHALWV  can 
simulate  the  wave  climate  for  a  specific  storm  or  idealized  events,  such  as  a 
standard  project  hurricane. 


nendix  A:  CMSGRID 


33.  Grid  development  is  a  major  part  of  successfully  applying  a 
numerical  model  to  a  specific  site.  Module  CMSGRID  contains  software  used  in 
the  generation  of  stretched  coordinate,  rectilinear  computational  grids  for 
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several  models  in  CMS.  The  software  employs  sophisticated  techniques  that 
allow  concentration  of  grid  cells  in  regions  of  interest,  or  where  geographic 
features  are  irregular,  and  wider  spacing  of  grid  cells  in  areas  where 
conditions  are  not  expected  to  change  rapidly.  The  ability  to  generate 
variably  spaced  grids  provides  economy  in  computational  time  and  costs. 
Generated  grids  can  be  plotted  to  scale  on  Mylar  for  overlaying  bathymetric 
charts  to  obtain  depths  and  elevations. 

Appendix  B:  CMSUTIL 

34.  Module  CMSUTIL  contains  useful  programs  that  supplement  numerical 
models  in  CMS.  Presently,  there  are  two  programs  in  this  module:  a  program 
to  determine  tidal  constituents  from  a  time -history  of  tidal  elevations,  and  a 
program  to  generate  a  time  series  of  water  elevations  from  tidal  constituent 
input . 


Appendix  C:  CMSPOST 

35.  Most  numerical  models  generate  large  output  files  containing 
results  saved  at  user- specified  grid  cells  and  time -steps  during  the  simula¬ 
tion.  Module  CMSPOST  contains  post-processing  plotting  packages  that  plot  the 
model  output  for  comparison  and  analysis  purposes.  Four  basic  types  of 
plotting  are  available:  (a)  time-histories  of  field  arrays  such  as  water 
surface  elevation  or  velocity  at  selected  grid  points,  (b)  "snapshots"  of  the 
entire  flow  field  at  a  given  instant  in  time,  (c)  wave  ray  plots,  and 
(d)  profile  plots  that  show  the  spatial  variation  of  a  model  variable  at  an 
instant  in  time. 


Reference 


National  Oceanic  and  Atmospheric  Administration.  1979.  "Meteorological 
Criteria  for  Standard  Project  Hurricane  and  Probable  Maximum  Hurricane  Wind 
Fields,  Gulf  and  East  Coasts  of  the  United  States,"  Technical  Report  NWS  23, 
National  Weather  Service,  Washington,  DC. 
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CHAPTER  2 

USING  THE  COASTAL  MODELING  SYSTEM 


PART  I:  ACCESS  TO  THE  VAX  8800  AND  CRAY  Y-MP 

Introduction 

1.  The  Coastal  Modeling  System  (CMS)  is  available  to  all  Corps  elements 
through  the  CRAY  Y-MP  supercomputer  that  resides  at  the  Information  Technology 
Laboratory  (ITL) ,  US  Army  Waterways  Experiments  Station  (WES).  This  chapter 
provides  a  detailed  description  of  the  steps  necessary  to  use  the  CMS.  In 
addition,  sample  runs  of  several  models  in  the  CMS  are  given  for  illustration. 

Computer  Account  Information 

2.  A  computer  account  for  both  the  VAX  8800  and  CRAY  Y-MP  can  be 
obtained  by  calling  the  Customer  Assistance  Center  (CAC)  at  WES  (601) 

634-4400.  Although  it  is  no  longer  necessary  to  have  a  VAX  8800  account  to 
access  the  CRAY  Y-MP,  it  is  recommended  that  the  user  obtain  a  VAX  8800 
account  for  data  manipulation  purposes.  Cost  for  usage  of  the  CRAY  is  $500/hr 
and  $100/hr  for  the  VAX  8800.  Disk  storage  will  be  billed  at  the  rate  of 

$1 . 60/megaword- day  (1  megaword  -  8  megabytes)  on  both  systems.  A 
DA  448  -  Military  Interagency  Purchasing  Request  (MIPR)  or  a  DA  2544  funding 
document  must  be  sent  to  WES -CAC  before  computer  accounts  can  be  set  up  on  the 
CRAY  or  VAX. 


Login  Procedure  for  the  VAX  8800  and  CRAY  Y-MP 

3.  A  user  can  log  onto  the  VAX  8800  through  the  INTERNET  network  or  a 
modem.  (INTERNET  is  a  national  collection  of  networks  including  MILNET, 
NSFNET ,  ARPANET,  ASNET ,  SURANET,  and  BITNET.)  The  login  procedure  is  as 
follows: 

a.  To  log  onto  the  ITL  VAX  8800  through  the  INTERNET  network, 
type  in  the  following  command  at  your  remote  workstation: 

talnet  iraaiaS.wes.arsQr.atl  <tbt> 
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or 


where  134.164.4.1  is  the  INTERNET  address  for  the  ITL  VAX  8800. 
t.  To  log  onto  the  ITL  VAX  8800  through  a  1200  or  2400  modem: 

(1)  Dial  (601)  634-4458  or  FTS  542-4458  to  connect  to  the 
terminal  server. 

(2)  Press  the  RETURN  key  twice  after  the  terminal  server  is 
connected. 

(3)  Type  in  the  command: 

«  wesi»3  • «ar*t> 

A  9600  baud  modem  can  also  be  used.  The  telephone  number  for  the  9600  baud 
rate  is  (601)  634-4426  or  FTS  542-4426. 

4.  Once  connected  to  the  ITL  VAX  8800,  a  user  can  log  onto  the 
CRAY  Y-MP  from  the  VAX  8800.  The  user  can  also  connect  directly  to  the  CRAY 
Y-MP,  if  so  desired.  It  should  be  noted  that  the  UNICOS  operating  system  is 
case  sensitive;  therefore,  terminal  keyboard  CAPS  LOCK  should  remain  "off"  for 
all  CRAY  Y-MP  sessions. 

&■  To  log  onto  the  CRAY  Y-MP  through  the  VAX  8800,  type: 

b-  To  log  onto  the  CRAY  Y-MP  through  the  INTERNET  network,  type: 

telnet  : .  ... 

or 

134.164.8.2  <eeO 

where  134.164.8.2  is  the  INTERNET  address  of  the  WES  CRAY  Y-MP. 
£.  To  log  onto  the  CRAY  Y-MP  through  a  modem: 


2-2 


(1)  Dial  (601)  634-4458  or  FTS  542-4458  to  connect  to  the 
terminal  server. 

(2)  Press  the  RETURN  key  twice  after  the  terminal  server  is 
connected. 

(3)  Type  in  the  command: 


The  computer  will  then  prompt  the  user  for  the  username  and  password  for 
his/her  account. 
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PART  II:  ACCESSING  CMS 


5.  CMS  is  a  command  procedure  file  or  "shell  script"  for  using  models 
in  CMS.  The  script  serves  two  purposes:  (a)  it  builds  the  necessary 
preprocessor  file  and  compiled  source  code  of  the  desired  model,  and  (b)  it 
loads,  links,  and  executes  the  model.  The  steps  necessary  to  use  CMS  are  as 
follows : 

g.  To  access  CMS,  type  in  the  command: 


Note  that  CMS  resides  on  the  CRAY  Y-MP  account  /u3/h2crplc0 ; 
therefore,  the  user  must  provide  this  path  name  when  accessing 
CMS.  The  computer  will  then  prompt  the  user  with  a  series  of 
questions,  in  menu  form,  concerning: 

(1)  The  desired  model  name  (see  Table  2-1). 

(2)  The  model  procedure  name,  which  is  either  BUILD  (or  build), 
RUN  (or  run),  or  EXIT  (or  exit)  where  "build"  is  used  for 
compiling  and  linking  the  model,  "run"  is  used  for  model 
execution,  and  "exit"  is  used  to  terminate  the  CMS  session. 

(3)  The  input  and  output  filenames.  Filenames  should  be 
limited  to  8  digits  with  3 -digit  extensions  if  they  are  to 
be  transferred  to  a  personal  computer  (PC).  It  is 
recommended  that  input  files  be  created  and  edited  on  the 
VAX  8800  or  on  the  user's  PC  and  transferred  to  the  CRAY  Y- 
MP  for  CMS  simulations. 

Following  the  entry  of  all  output  filenames,  CMS  launches  a 
batch  job  to  the  CRAY  Y-MP,  for  example: 


Request  1234.1arry  submitted  to  queue: prime 

where  1234  is  the  job  number  assigned  by  the  CRAY  Y-MP  for  the 
particular  run.  The  batch  queue  selected  by  the  system,  in  this 
case  "prime,"  is  based  on  the  estimated  execution  time  of  the 
job. 

b.  To  check  the  job  status  after  it  is  submitted  to  the  CRAY  Y-MP, 
the  user  can  type  in  the  UNICOS  command: 


qstsfc  -*  .  i;  <rst> 

where  -a  indicates  status  of  the  current  user's  batch  jobs  only. 
If  the  batch  job  is  still  in  the  batch  queue,  the  computer  will 
respond: 
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1234.1arry  wift#_bui  ld.com  h2crpac0  primeaglarry 
no  pipe  queue  entries 
no  device  queue  entries 


indicating  that  the  job  is  still  in  the  batch  queue.  If  the  job 
is  completed  (compiled  or  executed),  the  computer  will  respond: 


no  batch  queue  entries 
no  pipe  queue  entries 
no  device  queue  entries 


6.  To  save  computing  time  and  expenses,  CMS  is  divided  into  two  parts: 
(a)  compilation  and  (b)  execution.  The  user  can  change  certain  values  in  the 
input  data  set  without  recompiling  the  model.  However,  changing  certain 
crucial  values  will  require  recompilation.  After  the  job's  completion,  system 
output  files  will  be  generated  and  will  reside  in  the  user's  working 
directory.  The  two  files  generated  after  model  compilation  are  named 
Modelbu.exxxx  and  Modelbu.oxxxx,  and  the  two  system  output  files  generated 
after  model  execution  are  Model_ru.exxxx  and  Model_ru.oxxxx.  The  xxxx  is  the 
4  or  5-digit  job  number  assigned  by  the  system  (depending  on  the  CRAY  Y-MP 
schedule)  for  the  particular  run.  The  .e  file  contains  compiling  or  execution 
error  messages  while  the  .o  file  contains  a  summary  report  of  the  job 
accounting  information.  Example  filenames  are  given  in  Table  2-1. 

Table  2-1 
Example  Filenames 


Example  Procedure  Example  File  Produced 

Build  WIFM  WIFM_BU.E1234 

WIFM  BU. 01234 


Run  WIFM 


WIFM_RU. E5678 
WIFM  RU. 05678 


7 .  To  read  the  error  messages  or  the  accounting  report ,  the  user  can 
type  the  UNICOS  command 


where  "file_nameM  is  a  filename  in  the  form  mentioned  previously  and  in  Table 
2-1.  The  pg  command  displays  the  text  file  on  a  terminal,  one  screenful  at  a 
time.  The  user  can  press  the  return  key  to  view  another  screenful  or  3  to 
terminate  viewing  of  the  particular  file.  The  UNICOS  command  cat  is  not 
recommended  for  this  purpose  because  the  entire  file  will  scroll  onto  the 
terminal  screen  and  it  is  difficult  to  terminate  the  scrolling  process. 
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PART  III:  ILLUSTRATIONS  OF  CMS 

Compilation 

8.  For  illustrative  purposes,  model  WIFM  was  selected  for  compilation. 
Compilation  of  any  of  the  other  models  in  the  CMS  is  identical  to  the 
procedure  given  below.  The  user: 

§l.  Invokes  CMS. 

i>.  Selects  the  name  of  the  desired  model. 

c.  Selects  "BUILD"  to  compile  and  link  the  desired  model. 

d.  Enters  the  input  filename  to  be  used  for  the  subsequent  model 
run. 

9.  CMS  resides  on  the  CRAY  Y-MP  account  /u3/h2crplc0 ;  therefore,  the 
user  must  provide  this  path  name  when  accessing  CMS.  To  compile  model  WIFM, 
the  user  (h2crplcl  for  the  following  examples)  invokes  CMS  by  entering  the 
information  shaded  below  (step  a) .  It  should  be  noted  that  user  entries  are 
shown  as  shaded  and  CMS  response  "screens"  are  shaded  boxes.  The  information 
preceding  the  shaded  command  in  step  &  (h2crplcl : larry$)  is  a  system  prompt. 

a .  h2crplcl :  larry$/uV^d»|k|^/;#fc 
The  CMS  responds : 
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Return  for  more,.. 

2-7 


*  Options 


*  CMSMODEL  (Compiles,  links,  loads,  and  executes 

*  numerical  models)  — . «• 


*  CMSPOST  (Plots  and  lists  model  outputs) 


*  CMSUTIL  (Additional  "utility**  programs) 


Enter  option  number  . - - - >  || 

The  CMS  responds: 
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for  more.  .  . 
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*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

*  * 

*  Options:  * 

*  * 

*  On-Line  Help  . - . . . . . - . - . >  1  * 

*  * 

*  Enter  CMSMODEL  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  - - - . . >  3  * 

*  * 


********************************************************************* 


Enter  option  number 
The  CMS  responds: 


>  2 


************************************************************ 

*  * 

*  Models  Presently  in  System  * 

************************************************************ 

CLHYD: 

Curvilinear  Hydrodynamic  2 -Dimensional  Model 

RCPWAVE: 

Regional  Coastal  Processes  Wave  Model 

SPH: 

Standard  Project  Hurricane  Wind  Model 

WIFM: 

WES  Implicit  Flooding  Model 

SWM: 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired: 
b.  Enter  name  of  model  wi£» 
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The  CMS  responds : 
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for  more. . . 

Select  Model  Procedure: 

BUILD  -  compile  and  link  model 

RUN  -  execute  model 

EXIT  -  terminate  computer  session 


For  this  example  WIFM  is  compiled  and  linked  by  responding  to  the  CMS  prompt 
with: 

c.  Enter  procedure  name  build 

The  user  is  prompted  for  the  input  data  set  as  follows: 

d.  Enter  name  of  input  data  file  /uVhicrplcl/vifo/te&t/nKHik.i&pl 

Note  that  the  name  of  the  user's  input  data  file  (/wifm/test/mock. inpl)  may  be 
different  from  that  given  in  step  d.  The  system  responds: 


Request  2710.1arry  submitted  to  queue:  prime. 
****  END  OF  CMS  PROCEDURE 


This  procedure  launches  a  batch  job  (number  2710)  to  the  CRAY  Y-MP. 
10.  To  check  the  status  of  the  batch  job,  the  user  types: 

h2crplcl :  larry$  -* 

When  the  system  responds: 


2-10. 


no  batch  queue  entries 
no  pipe  queue  entries 
no  device  queue  entries 


then  the  batch  job  is  completed. 

11.  To  check  the  status  of  files  produced  by  the  batch  job,  the  user 
types  the  following  to  check  the  status  of  the  error  file: 

h2crplcl:  larry$  Is 

-rw -  1  h2crpici  CERC  0  Aug  13  12:54  vlfm_bu. e2710 

and  the  following  to  check  the  status  of  the  output  files: 
h2crplcl:larry$  is  1 


-rw -  1  h2crplcl  CERC  1556  Aug  13  12:54  wifm_bu. o2710 

-rw -  1  h2crplcl  CERC  450504  Aug  13  12:54  vifmall.c 


The  .e2710  file  contains  compiling  error  messages,  and  the  ,o2710  file 
contains  a  summary  report  of  the  job  accounting  information. 

12.  To  view  the  compiling  error  message,  the  user  types: 

h2crplcl :  larry$  |§| 

In  this  case,  there  are  no  error  messages.  If  the  user  encounters  compilation 
errors,  he  or  she  should  call  the  Coastal  Engineering  Research  Center  (CERC) 
CMS  representative. 

13.  To  view  the  summary  report  of  the  job  accounting  information,  the 
user  types: 

h2crplcl:larry$  pg  wi£»J>tt.o27l0 


The  system  responds: 


| 
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USAEWES  Information  Technology  Laboratory 
CRAY  Y-MP  8/6128  (UNICOS  5.1) 

Questions/problems/comments  -->  call  Customer  Assistance  at 
(601)634-4400  or  send  mall  to  cag@wesim3 

%%  Use  'bull'  for  Information  on  tapes,  printer,  and  other  news.  %% 


Job  Accounting  -  Summary  Report 


Job  Accounting  File  Name 
Operating  System 
User  Name  (ID) 

Group  Name  (ID) 

Account  Name  (ID) 

Job  Name  (ID) 

Report  Starts 

Report  Ends 

Elapsed  Time 

User  CPU  Time 

System  CPU  Time 

I/O  Wait  Time  (Locked) 

I/O  Wait  Time  (Unlocked) 

CPU  Time  Memory  Integral 
SDS  Time  Memory  Integral 
I/O  Wait  Time  Memory  Integral 
Data  Transferred 
Logical  I/O  Requests 
Physical  I/O  Requests 
Number  of  Commands 
Billing  Units 


/tmp/nqs .  +-H-H-0+eL/ .  j  acctll66 
snl022  larry  5.1  1022.15  CRAY  Y-MP 
h2crplcl  (1458) 

CERC  (105) 

A- 00000  (0) 
wlfm_build.com  (1166) 

08/13/90  12:53:20 
08/13/90  12:54:02 

42  Seconds 

36.2225  Seconds 
0:8803  Seconds 
0:1809  Seconds 
0.6861  Seconds 
35.9472  Mword- seconds 
0.0000  Mword- seconds 
0.2086  Mword- seconds 
2.1089  Mbytes 
518 
454 
16 

0.0000 


Execution 

14.  Models  WIFM,  SPH,  CLHYD,  and  HARBD  were  selected  for  execution. 
The  user  is  referred  to  Chapter  7  for  illustrations  of  SHALWV.  To  execute 
modeldWfFM,  the  user  types: 

a.  h2crplcl : larry$  /u3/h2crplc0/cma 
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The  CHS  responds : 


********************************************************************* 


*  CMS  COMPONENTS  * 

********************************************************************* 

*  Options:  * 

*  * 

*  CMS GRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1* 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - . - . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 


********************************************************************* 


Enter  option  number  . >  2 

The  CMS  responds : 
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Return  for  more. 


********^******VMMf******^*****llHf*******^******^*****i/MMIr********** 


* 

* 

* 

*4 

* 

* 
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* 

* 

* 

* 

* 


USING  THE  COASTAL  MODELING  SYSTEM 

k*****-. 

Options : 

On-Line  Help  ----- . - . . . - . - . >  1 

Enter  CMSMODEL  Module  . >  2 

Return  to  Main  Menu  . . . . . . >  3 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


****:Hhfc**************^******s^******^******^********************** 


Enter  option  number 
The  CMS  responds : 


->  i 
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* 


Models  Presently  in  System 


* 


CLHYD: 

RCPWAVE: 

SPH: 

WIFM: 

SWM: 

EXIT: 


Curvilinear  Hydrodynamic  2 -Dimensional  Model 

Regional  Coastal  Processes  Vave  Model 

Standard  Project  Hurricane  Wind  Model 

WES  Implicit  Flooding  Model 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

Terminate  computer  session 


The  user  is  prompted  to  enter  the  name  of  the  model  desired: 

b .  Enter  name  of  model  f&fp 
The  CMS  responds : 
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for  more . . . 

Select  Model  Procedure: 

BUILD  -  compile  and  link  model 

RUN  -  execute  model 

EXIT  -  terminate  computer  session 
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For  this  example  WIFM  is  executed  by  responding  to  the  CMS  prompt  with: 


£• 


Enter  procedure  name 


The  user  Is  prompted  for  the  input  and  output  data  sets  as  follows.  Mote  that 
the  names  of  the  user's  input  and  output  files  may  differ  from  those  given  in 
steps  d,  £,  g,  and  h.  Example  input  and  output  files  can  be  found  in 
Chapter  4. 

4.  Enter  name  of  input  data  file 

A  hotstart  simulation  indicates  that  model  results  (water  surface  elevations 

and  velocities)  have  been  saved  from  a  previous  simulation  and  are  to  be  used 

as  initial  conditions  for  the  present  simulation: 

£.  Is  this  a  HOTSTART  simulation? 

Enter  y[es]  or  n(o]  to  continue  f§ 

f .  Enter  the  name  of  the  output  data  file  •fiKSguottt 
outdeck  -  mock. out 

Hydrograph  data  are  time-histories  of  model  results  (i.e.,  water  surface 
elevations  and  velocities)  at  selected  (gage)  points  in  the  computational 
domain. 

g.  Do  you  want  to  save  hydrographic  data? 

Enter  y[es]  or  n[o]  to  continue  y 

Enter  the  name  of  the  hydrograph  data  file 

A  snapshot  is  a  "picture"  of  the  flow  field  for  the  entire  grid  or  a  portion 
of  the  grid  at  a  given  instant  in  time. 

h.  Do  you  want  to  save  snapshots? 

Enter  y[es]  or  n[o]  to  continue  y 

Enter  the  name  of  the  snapshot  data  file  Bode*  *npl 

Hotstart  data  (water  surface  elevations  and  velocities)  can  be  saved  for  the 
entire  computational  domain  for  use  in  a  subsequent  simulation. 

i.  Do  you  want  to  save  hotstart  data? 

Enter  y[es]  or  n[o]  to  continue  fii 

The  system  responds: 


Request  2713.1arry  submitted  to  queue:  prime. 
****  END  OF  CMS  PROCEDURE 
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This  procedure  launches  a  batch  job  (number  2713)  to  the  CRAY  Y-MP. 


15.  In  order  to  check  the  status  of  the  batch  job,  the  user  types: 

h2crplcl :  larry$  flpillll 

If  the  job  is  still  in  the  batch  queue,  the  computer  will  respond: 


2713.1arry  wifm_run.com  h2crpmcO  prime@larry 
no  pipe  queues  entries 
no  device  queue  entries 


When  the  system  responds: 


no  batch  queue  entries 
no  pipe  queue  entries 
no  device  queue  entries 


then  the  batch  job  is  completed. 

16.  To  check  the  status  of  files  produced  by  the  batch  job,  the  user 

types : 

h2crplcl:larry$  Id  -I 


-rw -  1  h2crplcl  CERC  0  Aug  13  12:54  wifm_bu. e2710 

-rw -  1  h2crplcl  CERC  73  Aug  13  13:01  wifm_ru.e2713 

and 

h2crp.cl:larry$  la  «1  *.0* 

-rw -  1  h2crplcl  CERC  140567  Aug  13  13:01  mock. out 

-rw -  1  h2crplcl  CERC  0  Aug  13  13:01  wifm.out 

-rw -  1  h2crplcl  CERC  1556  Aug  13  12:54  wifm_bu.o2710 

-rw -  1  h2crplcl  CERC  1554  Aug  13  13:01  wifm_ru.o2713 

-rw -  1  h2crplcl  CERC  450504  Aug  13  12:54  wifmall.o 


The  .e  file  contains  compiling  error  messages,  and  the  .o  file  contains  a 
summary  report  of  the  job  accounting  information. 

17.  To  view  the  system  error  messages,  the  user  types: 
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h2crplcl :  larry$  pg  «tfil  W, 


The  system  responds: 


In  this  case,  there  are  no  error  messages.  Types  of  errors  one  might 
encounter  include: 


Floating  exception 

TB001  -  BEGINNING  OF  TRACEBACK 

-  $TRBK  WAS  CALLED  BY  f_sig  AT  234471a  (LINE  NUMBER 

-  fsig  WAS  CALLED  BY  CALLFUNC  AT  204414c 

-  CALLFUNC  WAS  CALLED  BY  WIFMXY  AT  31402a 

-  WIFMXY  WAS  CALLED  BY  WIFM  AT  664c 

-  WIFM  WAS  CALLED  BY  $START$  AT  136d 

TB002  -  END  OF  TRACEBACK 


235) 


(LINE  NUMBER  236) 


which  indicates  that  a  "floating  divide  by  zero"  or  a  dimensioning  problem  was 
encountered  during  the  simulation.  If  this  occurs,  call  the  CERC  CMS 
representative.  Input  errors  would  not  be  indicated  in  the  system  error  file 
(wifmru. e2713) ,  but  can  be  found  in  the  model  output  file  (mock. out).  A 
sample  output  file  with  errors  should  be  examined  as  shown  in  Table  2-2.  The 
underlined  information  in  Table  2-2  is  typed  by  the  user,  making  use  of  the 
CRAY  line  editor  (see  UNICOS  primer  SG-2010  C) . 


Table  2-2 


£  to  go  to  the  end  of  the  file 

*****  PROGRAM  ABORTING  !  !!!  ! 

q  to  determine  the  line  number  at  the  end  of  file 

242  *****  PROGRAM  ABORTING  ! ! ! ! ! 

230. So  to  type  lines  230  to  the  end  of  file 

***  FATAL  ERRORS  -  2  WARNINGS  -  0 

*****  SYSTEM  SPECIFICATION  --  "FNGLISH  "  NOT  RECOGNIZED  !!!!! 

*****  PROGRAM  ABORTING  ! ! ! ! ! 

18.  To  view  the  summary  report  of  the  job  accounting  information,  the 
user  types : 

h2crplcl :  larry?  pg  ru.p&713 

The  system  responds : 
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USAEWES  Information  Technology  Laboratory 
CRAY  Y-MP  8/6128  (UNICOS  5.1) 


Questions/problems/comments  -->  call  Customer  Assistance  at 
(601)634-4400  or  send  mail  to  cag@wesim3 

%%  Use  'bull'  for  information  on  tapes,  printer,  and  other  news.  %% 


Job  Accounting  -  Summary  Report 


Job  Accounting  File  Name 
Operating  System 
User  Name  (ID) 

Group  Name  (ID) 

Account  Name  (ID) 

Job  Name  (ID) 

Report  Starts 

Report  Ends 

Elapsed  Time 

User  CPU  Time 

System  CPU  Time 

I/O  Wait  Time  (Locked) 

I/O  Wait  Time  (Unlocked) 

CPU  Time  Memory  Integral 
SDS  Time  Memory  Integral 
I/O  Wait  Time  Memory  Integral 
Data  Transferred 
Logical  I/O  Requests 
Physical  I/O  Requests 
Number  of  Commands 
Billing  Units 


:  /tmp/nqs . ♦ H  t+Q+eO/ . j  acctll81 
:  snl022  larry  5.1  1022.15  CRAY  Y-MP 
:  h2crplcl  (1458) 

:  CERC  (105) 

:  A- 00000  (0) 

:  wifm  run.com  (1181) 

:  08/13/90  13:01:40 
:  08/13/90  13:01:51 
:  11  Seconds 

:  8.3513  Seconds 

:  0:1963  Seconds 

:  1:3230  Seconds 

:  1.0556  Seconds 

:  2.8742  Mword-seconds 

:  0.0000  Mword-seconds 

:  0.3517  Mword-seconds 

4.5823  Mbytes 
:  189 

:  260 

:  11 

:  0.0000 


19.  To  execute  model  SPH,  the  user  types: 
a.  h2crplcl : larry$  /u3/h2crplcO/cms 


The  CMS  responds: 
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Enter  option  number  . >  2 

The  CMS  responds: 
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Return  for  more.  .  . 


<* 


********************************************************************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMSMODEL  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  — . . . - . - . -->  3  * 

*  * 


********************************************************************* 


Enter  option  number  . . >  Z 

The  CMS  responds : 
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Models  Presently  In  System 


CLHYD: 

Curvilinear  Hydrodynamic  2 -Dimensional  Model 

RCPWAVE : 

Regional  Coastal  Processes  Wave  Model 

SFH: 

Standard  Project  Hurricane  Wind  Model 

WIFM: 

VES  Implicit  Flooding  Model 

SUM: 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired 
b .  Enter  name  of  model  §j||§ 

The  CMS  responds : 
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Return  for  more... 
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Select  Model  Procedure: 

BUILD  -  compile  end  link  model 

RUN  -  execute  model 

EXIT  -  terminate  computer  session 


For  this  example  SPH  Is  executed  by  responding  to  the  CMS  prompt  with: 

£.  Enter  procedure  name  fHi 

The  user  is  prompted  for  the  input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  users  input  and  output  files  may  differ  from  those  given  in 
steps  4.  e •  and  j[.  Example  input  and  output  files  can  be  found  in  Chapter  3. 


d. 


e 


Enter  the  name  of  the  input  data  file 


Enter  the  name  of  the  output  data  file 


Hydrograph  data  are  time -histories  of  model  results  (i.e.,  wind  velocities)  at 
selected  (gage)  points  in  the  computational  domain. 


f .  Do  you  want  to  save  hydrographic  data? 

Enter  y[es]  or  n[o]  to  continue  § 

Enter  the  name  of  the  hydrograph  data  file  feei&jBUlQFd 

A  snapshot  is  a  "picture"  of  the  flow  field  for  the  entire  grid  or  a  portion 
of  the  grid  at  a  given  instant  in  time. 

g.  Do  you  want  to  save  snapshots? 

Enter  y[es]  or  n[o]  to  continue  j£ 

The  system  responds: 


Request  8640.1arry  subfitted  to  queue:  prime. 
****  END  OF  CMS  PROCEDURE 
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CHS  COMPONENTS 


Enter  option  number 


*  Options: 

* 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid) 


*  CMSMODEL  (Compiles,  links,  loads,  and  executes 


numerical  models) 


*  CMSPOST  (Plots  and  lists  model  outputs) 

* 

*  CMSUTIL  (Additional  "utility"  programs) 

* 

*  Exit  CMS  . . . — 
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The  CMS  responds: 
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Return 

for  more.  .  . 

Enter  option  number  - - >  |jj 

The  CMS  responds: 
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***»*»*^»i^i^»*»»e1HH^*****'*»**'»M*^*  *******■*■**’»**»»■»*»»♦»<****** 
*  Models  Presently  in  System  * 

CLHYD: 

Curvilinear  Hydrodynamic  2 -Dimensional  Model 

RCPWAVE : 

Regional  Coastal  Processes  Wave  Model 

SPH: 

Standard  Project  Hurricane  Wind  Model 

WIFM: 

WES  Implicit  Flooding  Model 

SWM: 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired: 

t> .  Enter  name  of  model  rcpvav* 

The  CMS  responds: 
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Return 

for 

more. 
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Select  Model  Procedure: 

BUILD  -  compile  end  link  node 1 

RUN  •  execute  model 

EXIT  •  terminete  computer  session 


For  this  example  RCPWAVE  is  executed  by  responding  to  the  CMS  prompt  with: 

£.  Enter  procedure  name  ||p 

The  user  is  prompted  for  the  input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  user's  input  and  output  files  may  differ  from  those  given  in 
steps  ,  and  g.  Example  input  and  output  file  can  be  found  in 

Chapter  5. 

4.  Enter  name  of  input  date  file 
The  general  output  file  can  be  given  a  default  filename: 

e.  Enter  the  name  of  the  output  data  file  <r#t>< 

Default  output  filename  ia  rcpvave.out 

The  ray  plot  data  are  used  to  produce  wave  ray  plots  of  model  results  using 
the  CMS POST  program  RAYPLT  (see  Appendix  C) . 

f .  Enter  the  name  of  the  output  file  for  ray  plot  data  iiiiii 
Default  output  filename  for  ray  plot  data  is  rcpvave.ang 

The  shoreline  data  are  also  used  with  program  RAYPLT: 

g.  Enter  the  name  of  the  output  file  for  shoreline  data  |§|§1§§ 
Default  output  filename  for  shoreline  data  is  rcpvave.shl 

The  system  responds : 


Request  7280.1arry  submitted  to  queue:  prime. 
****  END  OF  CMS  PROCEDURE 


This  procedure  launches  a  batch  job  (number  7280)  to  the  CRAY  Y-MP. 
To  execute  model  CLHYD,  the  user  types: 
g.  h2crplcl:larry$ 
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Return  for 

more . . . 

*  cms  components  * 

«»§«.»  1--  ■!-.«■  -4-  »-»--»  ■■  l..«.  I- -I  -  l.-l.  ■!-,  «._»_■>  _ t.,4-1 

*  Options:  .  ■  ,  * 

*  * 

♦  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  - - >  1  * 


*  CMSMODEL  (Compiles,  links,  loads,  and  executes 

*  numerical  models)  - . .  — 

* 

*  CMSPOST  (Plots  and  lists  model  outputs)  - 

* 

*  CMSUTIL  (Additional  "utility"  programs)  - 

* 

*  Exit  CMS  . 


->  2  * 
* 

->  3  * 

* 

->  4  * 
* 

->  e  * 


Enter  option  number 
The  CMS  responds: 
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Return  for  more.  .  . 


Enter  option  number 


->  I 


The  CMS  responds : 


Models  Presently  in  System 


CLHYD: 

Curvilinear  Hydrodynamic  2-Dimensional  Model 

RCPWAVE: 

Regional  Coastal  Processes  Wave  Model 

SPH: 

Standard  Project  Hurricane  Wind  Model 

WIFM: 

WES  Implicit  Flooding  Model 

SWM: 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired: 

b.  Enter  name  of  model  |§||g|| 

The  CMS  responds : 
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o  o  o 


For  this  example  CLHYD  is  executed  by  responding  to  the  CMS  prompt  with: 


c .  Enter  procedure  name  |||| 

The  user  is  prompted  for  the  input  and  output  data  seta  as  follows.  Note  that 
the  names  of  the  user's  input  and  output  files  may  differ  from  those  given  in 
steps  d,  £ ,  and  g.  Example  input  and  output  files  can  be  found  in  Chapter  6. 

d.  Enter  name  of  Input  data  file 

/u3/h2crplc  l/wif^t*s  t/india*ym2.  <  Hlg 


A  hotstart  simulation  indicates  that  model  results  (water  surface  elevations 

and  velocities)  have  been  saved  from  a  previous  simulation  and  are  to  be  used 

as  initial  conditions  for  the  present  simulation: 

e.  Is  this  a  HOTSTART  simulation? 

Enter  y[es]  or  n{o]  to  continue  j| 


f . 


Enter  the  name  of  the  output  data  file 


Hydrograph  data  are  time-histories  of  model  results  (i.e.,  water  surface 
elevations  and  velocities)  at  selected  (gage)  points  in  the  computational 
domain. 


£• 


Do  you  want  to  save  hydrographic  data? 

Enter  y[es]  or  n[o]  to  continue  f 

Enter  the  name  of  the  hydrograph  data  file 


h.  Do  you  wand  to  save  discharge  range  data? 
Enter  y[es]  or  n{o]  to  continue  jji 


A  snapshot  is  a  "picture"  of  the  flow  field  for  the  entire  grid  or  a  portion 

of  the  grid  at  a  given  instant  in  time. 

jL.  Do  you  want  to  save  snapshots? 

Enter  y[es]  or  n[o]  to  continue  §j 


The  system  responds: 


Request  7528.1arry  submitted  to  queue:  prime. 
****  END  OF  CMS  PROCEDURE 


This  procedure  launches  a  batch  job  (number  7528)  to  the  CRAY  Y-MP. 
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PART  IV:  CREATING  AND  EDITING  INPUT  FILES  TO  THE  CMS 


21.  It  is  recommended  that  input  files  to  the  CMS  be  created  and  edited 
on  the  VAX  8800  or  the  user's  PC,  rather  than  the  CRAY  Y-MP.  The  user  will  be 
more  familiar  with  his  or  her  own  PC,  and  in  addition,  the  CRAY  editor  is 
known  to  be  cumbersome.  The  input  files  can  then  be  transferred  to  the  CRAY 
Y-MP  for  use  with  the  CMS  (see  Part  V).  An  input  file  for  a  given  model  must 
conform  to  the  specifications  outlined  in  the  individual  model  chapters.  For 
example,  model  WIFM  requires  a  TIMESPECS  card  to  conform  to  the  following 
specifications : 


ftMESPECS  30.  SECONDS  0.  *6400,  360. 


where  each  variable  occupies  8,  16,  24,  or  32  columns.  It  is  recommended  that 
the  user  refer  to  Chapters  3  through  7  for  specific  model  input  requirements. 

A  portion  of  a  WIFM  input  file  is  given  in  Figure  2-1. 


GENSPECS 

WIFM  SIMULATION 

NO 

.  1:  TIDE 

WITHOUT  FEATHERING 

ENGLISH 

TIMESPEC 

30. 

SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGLISH 

75 

30 

500.  1000.  I 

PRWINDOW 

3600. 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XB0UNDRYC0NSTELV 

75 

1 

30 

1  BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2  1  BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2  1  BDRY2 

FUNCTION 

1HARMCNST 

CNREC0RD 

0.0 

1981 

6 

1 

2.5 

C0NSTIT 

M2 

3.97  199. 

,02 

FUNCTION 

2HARMCNST 

CNREC0RD 

0.0 

1981 

6 

1  2 

! . 6667 

C0NSTIT 

M2 

3.97  199. 

02 

XBARRIER 

17 

14 

14 

2.5 

XB1 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

XBARRIER 

20 

18 

18 

2.5 

XB5 

YBARRIER 

13 

17 

17 

2.5 

YB1 

Figure  2 

-1. 

Sample  WIFM  input  file 
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PART  V:  FILE  TRANSFER  PROCEDURE  BETWEEN  THE  VAX  8800  and  CRAY  Y-MP 


22.  When  logged  onto  the  VAX  8800,  files  can  be  transferred  to  and  from 
the  VAX  8800  as  follows : 

Log  onto  the  VAX  8800 
k-  Type: 

ftp  Xatry  '  <r*t> 

The  computer  will  prompt  the  user  to  enter  the  user's  account  and  password  for 
the  CRAY  Y-MP. 

£.  To  send  a  file  from  the  VAX  8800  to  the  CRAY  Y-MP,  type  in  the 
command : 

nut  VAX  file  name  CRAY  file  name  ~  . .  .  <r*t> 

;/.v/Se.v.v^:vAee,.v.v.v.v.v.v.v.v.v.v-v.v.v  aW-v,v.v.%v.v.ef!v//Av.v/Av.v.*.v.,.,.,.v.v,v:.,Xv.v..v.v.v.v.v.,1  >v.v.v.v.*.% 

Si.  To  get  a  file  from  the  CRAY  Y-MP  and  send  it  to  VAX  8800,  type 
in  the  command: 

get  dRAY^lla^aame  /  *  .  ***&> 

Note  that  file  transfer  is  to  the  main  or  root  directory  at  the  receiving  end. 
If  the  second  filename  is  omitted,  then  the  filename  will  remain  unchanged  on 
the  receiving  system. 

23.  When  logged  onto  the  CRAY  Y-MP,  files  can  be  transferred  to  and 
from  the  CRAY  Y-MP  as  follows: 

fl.  Log  onto  the  CRAY  Y-MP 
k-  Type: 

ftp  wesimS  <ret> 

The  computer  will  prompt  the  user  to  enter  the  user's  account  and  password  for 
the  VAX  8800. 

£.  To  send  a  file  from  the  CRAY  Y-MP  to  the  VAX  8800,  type  in  the 
command: 

put  CRAY_f ilename  VAX_f il«_naaa  <r*t> 

Si-  To  get  a  file  from  the  VAX  8800  to  the  CRAY  Y-MP,  type  in  the 
command : 

get  ' ;;  <*at> 
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CHAPTER  3 


STANDARD  PROJECT  HURRICANE  (SPH)  MODEL 
THEORY  AND  PROGRAM  DOCUMENTATION 

PART  I :  INTRODUCTION 

1.  Planning  and  design  of  coastal  structures  may  require  a  storm  surge 
analysis  to  obtain  a  design  water  level.  Statistical  methods,  where  the 
design  water  level  is  obtained  through  analyzing  historical  water  surface  ele¬ 
vation  records,  can  rarely  be  applied  because  of  the  infrequent  occurrence  of 
hurricanes  at  a  given  site.  Hence,  numerical  computational  methods  are  often 
used  to  simulate  storm  surge  events.  This  chapter  documents  the  Standard 
Project  Hurricane  (SPH)  wind-field  model  for  calculating  wind  velocity  and 
atmospheric  pressure  fields  generated  by  hurricanes.  This  information  can  be 
used  by  a  hydrodynam^:  model  to  determine  the  design  water  level. 

2 .  Model  SPH  is  one  of  several  models  the  Coastal  Engineering  Research 
Center  (CERC)  uses  for  performing  storm  surge  studies.  This  model's  function 
is  to  generate  wind  velocity  and  atmospheric  pressure  fields  for  subsequent 
use  by  the  hydrodynamic  model  WIFM.  Furthermore,  model  SPH  is  structured  so 
that  it  can  be  used  as  an  independent  model,  or  as  an  integrated  component  of 
model  WIFM. 

3.  Model  SPH  was  developed  from  the  meteorological  criteria  adopted  by 
the  National  Oceanic  and  Atmospheric  Administration  (NOAA)  (1979)  for  the  Gulf 
of  Mexico  and  East  Coast  of  the  United  States.  The  SPH  represents  a  steady- 
state,  hypothetical  hurricane  defined  by  the  following  set  of  interrelated 
parameters : 

a.  Longitude  and  latitude  at  the  low-pressure  center,  or  eye  of  a 
hurricane. 

b.  Central  pressure,  or  atmospheric  pressure  measured  at  the  eye  of 
a  hurricane . 

£.  Peripheral  pressure,  or  atmospheric  pressure  at  the  edge  of  a 
hurricane . 

d.  Track  angle,  measured  clockwise  from  north,  defining  the 
direction  in  which  a  hurricane  is  traveling. 

£.  Translational  speed,  or  forward  speed  of  a  hurricane. 

£.  Inflow  angle  of  winds,  accounting  for  the  inward  spiraling  of 
horizontal  wind  velocities  about  the  hurricane  center  measured 
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between  a  line  tangent  to  an  iso-velocity  circle  and  the  associ¬ 
ated  inflow  wind  velocity  vector. 

g.  Radius  to  maximum  winds,  measured  from  the  eye  of  a  hurricane  to 
the  iso-velocity  circle  of  maximum  wind  velocities. 

h.  Maximum  wind  speed,  either  defined  explicitly  or  calculated  from 
the  difference  between  central  and  ambient  pressures. 

i.  Radial  decay  factor,  defining  the  decrease  in  wind  speed  with 
increasing  radial  distance  outward  from  the  radius  to  maximum 
winds . 

j. .  Azimuth  angle  to  the  maximum  velocity  vector. 

4.  According  to  the  NOAA  definition,  the  Standard  Project  Hurricane 
represents  the  most  severe  hurricane,  excluding  extremely  rare  events, 
producing  the  highest  sustained  wind  speeds  for  a  specific  region.  Due  to 
uncertainties  involved  in  establishing  frequency  parameters,  the  NOAA  does  not 
assign  a  frequency  of  occurrence  to  a  Standard  Project  Hurricane.  Parameter 
values,  established  through  a  statistical  analysis  of  historical  hurricane 
events,  are  presented  in  this  chapter. 

5.  Model  SPH  was  originally  developed  for  simulating  a  steady-state, 
hypothetical  Standard  Project  Hurricane;  however,  features  have  been  added  to 
this  model  for  replicating  historical  hurricane  events.  Because  this  model’s 
governing  equations  were  developed  from  those  hurricanes  contained  in  NOAA's 
statistical  data  set,  this  model  may  not  be  ideally  suited  for  simulating 
individual  historical  events.  When  possible,  the  user  should  compare  model 
results  against  field  data  to  determine  whether  this  model  accurately  computes 
the  wind  velocity  and  atmospheric  pressure  fields  produced  by  historical 
storms  in  a  given  study  area. 

6.  This  chapter  is  organized  into  six  sections:  Part  II  presents  the 
development  of  the  governing  equations  and  computational  scheme  used  in  the 
model;  Part  III  presents  the  parameters  for  describing  SPH  and  historical 
storms;  Part  IV  discusses  the  model’s  input  data  requirements;  Part  V  defines 
the  input  data  formats;  and  Part  VI  contains  two  illustrative  examples. 
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PART  II:  COMPUTATIONAL  TECHNIQUE 


7.  Hurricane  wind  fields  are  characterized  by  high  winds  blowing 
spirally  inward  toward  a  low-pressure  center.  For  hurricanes  occurring  in  the 
Northern  Hemisphere,  wind  fields  rotate  in  a  counterclockwise  direction. 
Relatively  low  wind  speeds  are  experienced  at  the  hurricane's  center  and 
rapidly  increase  to  speeds  exceeding  75  knots*  at  a  radial  distance  that 
generally  ranges  from  4  to  60  n.m.  Wind  speeds  gradually  diminish  beyond  this 
point  as  the  radial  distance  extends  towards  the  storm's  periphery.  Atmo¬ 
spheric  pressures  are  lowest  at  the  storm's  center  and  slowly  increase  towards 
the  storm's  edge. 

8.  Although  winds  in  an  actual  hurricane  do  not  necessarily  rotate  in 
concentric  circles,  development  of  the  equation  for  computing  a  hurricane's 
maximum  theoretical  rotational  wind  speed  assumes  a  stationary  storm  where 
winds  blow  under  gradient  wind  conditions.  These  conditions  are  defined  as 
winds  blowing  in  a  circular  motion  parallel  to  the  storm’s  isobars,  such  that 
the  wind's  centripetal  and  coriolis  acceleration  forces  balance  the  horizontal 
pressure  gradient  force.  Gradient  wind  conditions  can  be  mathematically 
expressed  as: 


v2 

V9 


+  fv„  -  — 


=  A 

P. 


dP 

di 


(3-1) 


where 

Vg  -  gradient  wind  velocity 
r  -  radial  distance  measured  from  the  hurricane  center 
f  -  coriolis  acceleration  parameter 
pa  -  air  density 
P  -  atmospheric  pressure 

9.  NOAA  (1979)  found  that  when  hurricanes  occur  at  low  latitudes  and 
have  small  radii  to  maximum  winds,  the  maximum  wind  speeds  are  approximately 
in  cyclostrophic  balance.  This  means  that  the  wind's  centripetal  acceleration 
approximately  equals  the  horizontal  pressure  gradient: 


A  table  of  factors  for  converting  non- SI  units  of  measurement  to  SI 
(metric)  units  is  presented  on  page  vii. 
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v£  .  _1  dP 
r  ~  pM  dr 


where  Vc  is  the  cyclostrophic  wind  velocity. 

10.  Equating  Equations  3-1  and  3-2  yields: 


v2 

v9 


♦  fv„ 


vi 
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or 


V„  -  Ve 


~rfvs. 
Vg  *  Vt 


(3-4) 


11.  For  the  range  of  wind  speeds  used  in  hurricane  studies,  the 
difference  between  the  quantities  Vc  and  Fg  is  small  in  comparison  to  the 
quantities  themselves.  Therefore,  the  following  approximation  is  valid: 


^  = 


III 

2 


(3-5) 


12.  Schloemer  (1954)  developed  an  empirical  formula  for  approximating  a 
hurricane's  horizontal  pressure  distribution: 


or 

dP  _  (p-  ~  po]  Rc-*/r  (3-7) 

dr  x2 

where 

p  -  atmospheric  pressure  at  any  location 

P0  -  atmospheric  pressure  at  the  eye  of  the  hurricane 

Pa  -  atmospheric  pressure  at  the  periphery 

R  -  radial  distance  from  the  hurricane  center  to  the  location  of 

maximum  rotational  wind  speed 

13.  Expressing  the  cyclostrophic  wind  speed  in  terms  of  the  horizontal 
pressure  distribution  yields: 
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vc  -  [^^2/ie-^p  (3-8) 

14.  Substituting  Equation  3-8  into  3-5  and  evaluating  the  resulting 
equation  at  the  radius  to  maximum  winds,  the  maximum  theoretical  gradient  wind 
speed  is: 

=  K[P„  -  P0]»  -  M  (3-9) 

where  Vt%  is  the  maximum  theoretical  gradient  wind  speed,  and  K  is  a 
coefficient  accounting  for  air  density  at  the  air- sea  interface. 

15.  Myers  (1954)  observed  that  the  maximum  theoretical  gradient  wind 
speeds  predicted  by  Equation  3-9  overestimate  the  maximum  rotational  wind 
speeds  produced  by  historical,  stationary  hurricanes  in  open  water  by  as  much 
as  25  percent.  To  rectify  this  problem,  NOAA  (1979)  adopted  a  multiplicative 
correction  factor  of  0.90  to  adjust  a  hurricane's  maximum  theoretical  gradient 
wind  speed  to  obtain  the  maximum  rotational  wind  speed: 

Vx,  «  0.90  (3-10) 

where  Vxs  is  the  maximum  rotational  wind  speed  for  a  stationary  hurricane. 

16.  A  hurricane's  radial  wind  distribution  is  categorized  into  three 
zones  (Figure  3-1).  The  first  zone  extends  from  its  center  outward  to  a 
distance  that  is  80  percent  of  the  radius  to  maximum  winds  (j^) .  In  this 
zone,  wind  speeds  are  assumed  to  increase  linearly  from  zero  at  the  center,  to 
the  maximum  rotational  wind  speed  at  this  zone's  outer  radial  limit.  The 
second  zone,  where  wind  speeds  are  assumed  equal  to  the  maximum  wind  speeds, 
extends  for  the  first  zone's  outer  limit  to  a  distance  equal  to  120  percent  of 
the  radius  to  maximum  winds  (R^) .  Wind  speeds  in  the  third  zone ,  extending 
outward  from  the  second  zone's  outer  limit,  decay  exponentially  as  the  radial 
distance  approaches  the  storm's  edge. 

17.  To  reproduce  this  distribution,  model  SPH  employs  the  following 
wind  distribution  function: 


f(r) 


r/Rx  for  rKRi 
1  for  Rxir<Ru 

F,f(R0,R)  for  r*Ru 


(3-11) 
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Figure  3-1.  Radial  wind  distribution 


where 

f(r)  -  velocity  distribution  function 
R  -  radius  to  maximum  winds 
Re  -  effective  radius  parameter 

Fv(R9,R)  -  radial  velocity  reduction  function  originally  presented  by 
NOAA  (1979)  in  nomograph  form 

Applying  a  power  law  and  a  least-squares  regression  analysis,  the  nomograph 
can  be  mathematically  described  as : 

FH(R„R)  •  a1e'r‘/b'  *  a2e'T'/bl  (3-12) 

where 

_  (*•-*„) 

R 
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-  1  -  a,  bx  -  45l£0'500 

a3  =  0.33R^ia  jbj  =  3.4  R?30* 

Multiplying  the  maximum  rotational  wind  speed  presented  in  Equation  3-10  with 
the  wind  distribution  function,  the  wind  velocities  at  any  radial  distance, 

V ,  ,  can  be  computed  by: 

V, -f(r)F„  (3-13) 

18.  These  equations  were  developed  assuming  a  stationary  hurricane 
whose  wind  velocity  field  is  symmetric  about  its  center  (i.e.,  wind  velocity, 
while  dependent  in  the  radial  direction,  is  independent  of  the  angular 
direction).  Forward  motion  by  a  hurricane  induces  an  asymmetric  wind- field 
distribution  where  the  total  wind  velocity  vectors  (rotational  component  added 
to  the  forward  translational  component)  are  greater  in  the  hurricane's  right 
hemisphere  (relative  to  the  storm's  direction)  than  in  its  left  for  hurricanes 
occurring  in  the  Northern  Hemisphere.  Hence,  the  maximum  wind  velocity  occurs 
at  a  point  along  the  circumference  of  maximum  winds  where  the  rotational  wind 
velocity  vector  is  parallel  to  the  forward  velocity  vector  (Figure  3-2). 
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19.  Asstiming  Chat  a  hurricane's  forward  speed  is  incorporated  into 
Equation  3-13,  the  total  wind  velocity  at  any  location  within  the  hurricane 
can  be  computed  by: 

V  =  £(x)  V„  -  ±St(\-coa$)  (3-14) 

where  V„  is  the  maximum  wind  velocity,  St  is  the  forward  speed,  and  /9  is 
the  angle  formed  by  the  forward  velocity  vector  and  the  rotational  wind 
velocity  vector  (Figure  3-3).  This  angle  is  measured  in  a  counterclockwise 
direction  from  the  forward  velocity  vector.  Thus,  the  maximum  wind  speed  will 
occur  at  the  point  along  the  circumference  of  maximum  wind  speeds  where  is 
equal  to  zero. 

20.  However,  one  must  also  consider  the  inflow  angle,  a  ,  (Figure  3- 
4) .  The  inflow  angle  accounts  for  the  spiral  horizontal  wind  velocities  about 
the  hurricane  center  and  is  the  angle  measured  between  the  rotational  velocity 
vector  and  the  inflow  velocity  vector.  Although  this  angle  varies  with  radial 
distance  in  actual  hurricanes,  it  is  assumed  constant  in  model  SPH.  As  shown 
in  Figure  3-4,  the  maximum  wind  speed  occurs  where  the  inflow  velocity  vector 
is  parallel  to  the  forward  velocity  vector.  Typically,  this  point  is  in  a 
hurricane's  right-rear  quadrant  where  the  azimuth  angle,  d  ,  ranges  from  90 
to  180  deg. 


Figure  3-3.  Definition  sketch  for  angle 
to  rotational  wind  velocity  vector,  0 
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Figure  3-4.  Definition  sketch 
of  inflow  angle,  a 


21.  Equations  3-7  and  3-13  have  been  defined  relative  to  the  hurricane 
center.  In  the  model,  the  locations  where  the  wind  velocity  and  atmospheric 
pressure  fields  are  evaluated  are  defined  by  a  computational  grid  composed  of 
a  lattice  network  of  cells.  Wind  velocities  and  atmospheric  pressures  are 
computed  at  the  center  of  each  cell.  Distances  and  angles  from  the  center  of 
a  grid  cell  to  the  eye  of  the  hurricane  are  computed  relative  to  the  grid 
origin  by  the  following  relationships: 

i  =  [Uj-x,,)1  +  (y^-y*)2lv%  (3-15) 


♦  ■  aict“(l3) 


(3-16) 


where 


r 

* 

(xi >7j)  >  (xh.7h) 


distance 

angle 

grid  cell  and  hurricane  eye  coordinates,  respec 
tively  (Figure  3-5) 


22.  The  atmospheric  pressure  anomaly  is  computed  at  each  cell  by: 


AP 


D  -  D 

■"  °  (1  -  e"*/r) 

1 


(3-17) 
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where 


AP  -  pressure  head  anomaly 
P0  -  central  pressure 
P„  -  peripheral  pressure 
7  -  specific  weight  of  water 

r  -  radial  distance 

R  -  radius  from  the  eye  to  the  maximum  winds 


Figure  3-5.  Distance  and  angle  from  the  eye  of  a  hurricane  to  a  grid  cell 


23.  The  x-  and  y-direction  wind  velocities  are  computed  at  each  cell 
center  by: 


Wx  =  (f(r)  (1 -cosP>]  sin(4> +  «) 


(3-18) 


Wy  =  [fir)  V„  -  ^S/(l  -cos P)]  cos (<fr  +  a)  (3-19) 

where  Wx  and  Wy  are  the  x-  and  y-direction  wind  velocity  components, 
respectively. 

24.  As  a  hurricane  travels  towards  the  coastline,  the  leading  edge  of 
its  wind  field  moves  overland,  and  eventually  the  eye  of  the  storm  makes 
landfall.  The  rough  character  of  the  land  in  comparison  to  the  water  causes  a 
reduction  in  the  wind  speed.  Further  weakening  of  the  wind  field  takes  place 
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when  the  eye  moves  ashore.  The  storm's  energy  Is  reduced  because  the  surface 
air  is  no  longer  warmed  by  the  ocean.  The  wind  velocities  are  adjusted  for 
overland  effects  as  follows:  an  overland  reduction  factor  due  to  the  wind 
strength  is  computed  as: 

0.78  for  vs73  knots 

0[=  0.40  +  0 -38^-10)  for  10<  V<73  knots  (3-20) 

0.40  for  Vs  10  knots 

The  wind  components  Wx  and  Wy  are  then  given  by: 

Wx  =  Wx(l  -Rt(l  -Ot))  (3-21) 

Wy  =  Wy  (l  -*,(1  -Of))  (3-22) 

where  Rt  is  a  reduction  coefficient  that  accounts  for  the  fetch  length. 
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PART  HI:  DETERMINATION  OF  HURRICANE  PARAMETERS 

Parameters  for  the  SPH 

25.  One  use  of  model  SPH  is  for  calculating  the  meteorology  (winds  and 
pressures)  associated  with  the  SPH  for  a  particular  stretch  of  coastline. 
Reiterating,  the  SPH  represents  the  most  severe  hurricane,  excluding  extremely 
rare  events,  producing  the  highest  sustained  wind  speeds  for  a  specific 
region.  The  meteorological  parameters  necessary  to  compute  SPH  wind  fields 
are  referenced  relative  to  the  latitude  of  the  study  site  and  coastline 
distance  to  the  site  measured  relative  to  the  United  States -Mexico  border 
(Figure  3-6).  Coastline  distances  in  Figure  3-6  are  given  in  nautical  miles 
and  kilometers.  Figures  3-6  through  3-12  and  3-14  are  from  NOAA  Technical 
Report  No.  23  "Meteorological  Criteria  for  Standard  Project  Hurricane  and 
Probable  Maximum  Hurricane  Wind  Fields,  Gulf  and  East  Coasts  of  the  United 
States".  The  SPH  parameters  are  determined  in  the  following  manner: 

a.  Peripheral  pressure  is  equal  to  29.77  in.  Hg  in  allapplica¬ 
tions  . 

b.  Central  pressure  index  is  selected  from  Figure  3-7. 

c.  Forward  speed  is  chosen  from  Figure  3-8. 

d.  Radius  to  maximum  winds  is  selected  from  Figure  3-9. 

e.  Wind  inflow,  or  ingress  angle,  is  chosen  from  Figure  3-10. 

f .  Track  angle  (measured  clockwise  from  north) ,  for  which  a  range 
of  permissible  values  are  given,  is  selected  using  Figure  3-11 
and  Table  3-1. 

Parameters  selected  from  figures  and  tables  for  forward  speed,  radius  to 
maximum  winds,  and  track  direction  contain  a  range  of  suitable  values. 

Choosing  the  maximum  value  for  each  particular  parameter  does  not  guarantee 
that  the  predicted  wind  fields  will  generate  the  maximum  storm  surge  level. 
This  value  is  not  only  a  function  of  the  hurricane's  intensity,  but  also  a 
study  area's  hydraulic  features,  including  bathymetric  gradients,  inlet 
configurations ,  and  charnel  depths.  Several  parameter  combinations  must  be 
tested  when  performing  a  storm  surge  analysis  to  ensure  that  the  maximum  storm 
:ge  level  has  been  obtained. 
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Figure  3-6.  Location  map  with  coastal  distance  intervals 
marked  in  nautical  miles  and  kilometers  (from  NOAA 
Technical  Report  NWS  23) 
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Figure  3-10.  Adopted  SPH  inflow  angles  versus  distance  from  the  hurricane 
center  at  selected  R  values.  Open  circles  denote  maximum  inflow  angle 
at  each  R  (from  NOAA  Technical  Report  NWS  23) 
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RADIUS  OF  MAXIMUM  WINDS  N  Ml.  (KM) 


Figure  3-11.  Maximum  allowable  range  of  SPH  0  (from  NOAA  Technical  Report  NWS  23) 


Table  3-1 


Speed  Category  as  a  Function  of  Forward  Speed 


Forward  Speed 

Speed  Category  _ knots 


A 

6.0 

£ 

St  < 

10.0 

B 

10.0 

< 

St  < 

36.0 

C 

36.0 

< 

St 

26.  Maximum  rotational  wind  speed  is  computed  by: 

V„  =  0.90[AT(F.-i>o)'»  -  -Mj  (3-23) 

where 

Vxa  -  maximum  wind  speed 

K  -  coefficient  accounting  for  air  density  dependency  on  the 
latitude  of  the  study  site 

Pa  -  atmospheric  pressure  at  the  periphery 

P0  -  atmospheric  pressure  at  the  eye  of  the  hurricane 

R  -  radius  to  maximum  wind  velocities 

f  -  coriolis  parameter 

Coefficient  K  is  selected  from  Figure  3-12.  The  coriolis  parameter  is 
computed  by: 

f  =  2usin(X)  (3-24) 

where  w  is  the  earth's  angular  velocity  (equal  to  0.262  rad/hr)  and  A  is 
the  latitude  of  the  study  site. 

27.  The  angle  to  maximum  winds  or  azimuth  angle,  9  ,  is  the  angle 
formed  by  the  forward  velocity  vector  (i.e.,  the  direction  in  which  the 
hurricane  is  traveling)  and  a  radii  extending  from  the  eye  of  the  hurricane  to 
the  location  of  maximum  wind  speed  (Figure  3-13).  The  maximum  wind  speed 
incorporates  the  forward  and  rotational  wind  velocities,  including  inflow 
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Figure  3-12.  Values  of  the  latitude -independent  K  coefficient 
for  three  units  of  measurement  for  the  SPH  (from  NOAA  Technical 

Report  NWS  23) 


» 


Figure  3-13.  Definition  sketch  for  angle  to  maximum  winds 


effects.  This  angle  is  normally  between  90  and  180  deg  measured  in  a  clock¬ 
wise  direction  from  the  forward  velocity  vector. 

28.  The  effective  radius  parameter  is  a  scaling,  or  form  factor,  that 
adjusts  the  radial  wind  velocity  distribution  in  the  region  between  the  zone 
of  maximum  winds  and  the  storm's  periphery.  This  parameter  is  set  equal  to 
the  radius  to  maximum  winds  for  the  SPH. 

Parameters  for  Historical  Storms 

29.  Model  SPH  can  be  used  for  computing  the  meteorology  (winds  and 
pressures)  associated  with  a  historical  storm.  Certain  storm  parameters  which 
describe  the  hurricane  must  be  specified  as  a  function  of  time.  Model  SPH  can 
then  compute  the  wind  and  atmospheric  pressure  fields  at  user  specified  times. 
For  a  historical  hurricane,  the  storm's  movement  is  tracked  by  the  position  of 
its  eye,  rather  than  its  forward  speed  and  track  angle.  Values  for  the 
peripheral  pressure,  central  pressure,  radius  to  maximum  winds,  maximum  wind 
speed,  azimuth  angle,  and  inflow  angle  should  be  known  or  estimated  as  input 
to  the  model.  The  user  should  also  search  for  data  describing  the  wind- field 
distribution  outside  the  maximum  wind  band.  To  compute  the  effective  radius 
parameter  the  user  should: 

a.  Compute  and  plot  the  relative  wind  speed  (the  ratio  of  wind 
speed  to  over-water  maximum  wind  speed)  for  several  radii 
beyond  the  radius  to  maximum  winds. 

b.  Compare  the  curve  developed  in  item  (a)  to  the  nomographs 
presented  in  Figure  3-14. 

c.  Select  an  effective  radius  parameter  corresponding  to  the  value 
given  for  the  curve  on  the  nomograph  that  most  closely  resem¬ 
bles  the  historical  wind- field  distribution. 

Figure  3-14  presents  the  far-field  radial  wind  distribution  for  selected 
values  of  the  parameter  radius  to  maximum  winds.  Radial  distances  presented 
along  the  figure's  x-axis  are  measured  relative  to  the  hurricane's  center. 
Furthermore,  each  nomograph  assumes  a  stationary  hurricane.  Thus,  asymmetric 
effects  induced  by  a  storm's  forward  motion  must  be  eliminated  before  compar¬ 
ing  historical  data  to  this  figure. 
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Figure  3-14.  Standardized  wind  profiles  outward  from  R  for 
the  stationary  SPH  (from  NOAA  Technical  Report  NWS  23) 
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PART  IV:  DISCUSSION  OF  INPUT  DATA  REQUIREMENTS 


30.  The  structure  of  model  SPH  allows  It  to  be  used  as  an  independent 
or  "stand-alone"  model,  or  as  a  component  of  the  hydrodynamic  model  WIFM. 

WIFM  (see  Chapter  4)  shares  those  subroutines  in  model  SPH  that  compute 
hurricane  wind  and  pressure  anomaly  fields,  and  model  SPH  can  therefore  be 
executed  within  the  context  of  a  WIFM  simulation.  This  feature  saves  labor 
and  computer  costs  associated  with  running  model  SPH  independently  to  generate 
wind  fields  for  WIFM  applications.  For  a  stand-alone  application,  the 
discussion  of  input  data  requirements  are  divided  into  five  categories: 

fl.  Model  control  specifications. 

b-  Grid  description. 

£.  Physical  characteristics. 

4-  Wind-field  specifications. 

£.  Output  specifications. 

29.  For  applying  model  SPH  as  a  component  of  WIFM,  the  user  should 
review  item  (d)  and  the  input  data  requirements  for  WIFM.  Wind- field  input 
data  are  identical  for  both  models.  Table  3-2  presents  model  SPH  input  data 
records  pertaining  to  each  category.  (A  record  refers  to  one  line  of  data, 
and  each  record  begins  with  a  mnemonic  character  string  to  identify  one  record 
type  from  another.)  Record  format  and  detailed  descriptions  of  input  data 
entered  on  each  record  are  provided  in  Part  V.  While  reading  Part  IV,  the 
user  will  find  it  beneficial  to  refer  to  Appendix  3-A. 

Model  Control  Specifications 

31.  Model  control  data  records  include  GENSPECS  and  TIMESPEC.  Record 
GENSPECS  is  used  for  specifying  the  general  title  of  the  simulation  (TITLE) 
and  the  system  of  units  (SUNITS)  for  displaying  model  results.  Variable  names 
are  given  in  parentheses.  In  addition  to  the  general  title,  other  input  data 
records  have  provision  for  titles.  Although  this  information  is  optional,  it 
can  be  very  helpful  when  reviewing  a  series  of  simulations.  A  title  should 
specifically  state  data  set  attributes  to  distinguish  one  simulation  from 
another . 
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Table  3-2 


Input  Data  Set  Records 


Category 

Record  Name 

Model  control  specifications 

GENSPECS 

TIMESPEC 

Grid  description 

GRIDSPEC 

XSTRETCH 

YSTRETCH 

Physical  characteristics 

BATHSPEC 

CHNGBATH 

Wind- field  specifications 

WINDSPEC 

SPHSPEC 

TABSPH 

Output  specifications 

PRWINDOW 

RECGAGE 

REC SNAPS 

32.  Model  output  Is  presented  in  either  British  or  SI  units.  However, 
the  user  can  specify  a  different  system  of  units  for  the  input  data.  For 
example,  the  user  can  supply  wind  velocity  data  in  units  of  either  miles-per- 
hour,  feet-per-second,  meters-per-second,  or  knots.  Model  SPH  will  perform 
the  necessary  conversion  to  place  the  input  data  into  the  system  of  units  used 
for  computations . 

33.  Record  TIMESPEC  controls  the  processing  of  all  time-related 
variables.  Variable  DELT  defines  the  time -step  or  time  interval  when  wind- 
field  data  may  be  saved  for  use  by  a  hydrodynamic  model  and  must  have  units  of 
seconds.  DELT  is  also  the  time -step  used  by  WIFM  and  is  generally  smaller 
than  the  time-step  required  for  SPH  model  computations  (SPHDLT).  Variable 
TUNITS  controls  the  units  of  all  other  time -dependent  variables  (e.g., 

DTGAGS) .  Valid  time  units  are  hours,  minutes,  and  seconds. 

34.  Variable  TPROV  defines  the  provisional  model  time  at  the  start  of 
the  simulation,  and  variable  TMAX  controls  the  simulation's  duration. 
Typically,  a  hurricane  simulation  begins  at  time  0.0  and  has  a  duration 
exceeding  24  hr.  This  duration  provides  a  hydrodynamic  model  sufficient  time 
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in  which  to  develop  accurate  circulation  fields  and  avoids  the  generation  of 
numerical  instabilities  induced  by  instantaneously  applying  high  wind  veloci¬ 
ties  to  a  static  water  basin. 

35.  Variable  DTGAGS  specifies  the  frequency  at  which  numerical  gage 
time-history  data  (i.e.,  wind  velocities  and  atmospheric  pressures)  are  saved 
for  future  processing  by  the  post-processing  package  in  the  Coastal  Modeling 
System  (CMS).  Quantities  assigned  to  this  variable  must  be  an  integer 
multiple  of  the  time-step  variable  DELT.  Numerical  gage  locations  (locations 
for  which  time-histories  are  saved)  are  selected  with  the  RECGAGES  record, 
which  is  discussed  in  the  model  output  specification  section. 

Grid  Description 

36.  The  study  area  is  defined  in  the  model  via  a  computational  grid. 

The  grid  is  composed  of  rectilinear  cells,  where  each  cell  is  assigned  a  two- 
dimensional  index.  The  first  index  (i)  corresponds  to  the  x-coordinate  and 
the  second  index  ( j )  corresponds  to  the  y-coordinate .  The  grid  index  system 
is  presented  in  Figure  3-15.  All  wind-field  and  atmospheric  pressure  data  are 
assigned  and  referenced  to  their  respective  grid  cells  with  this  system. 
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Figure  3-15.  Definition  of  coordinate 
system  and  grid  cell  convention 
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37.  Model  SFH  permits  a  rectilinear  stretched  grid  coordinate  system, 
where  successive  grid  cells  can  have  smoothly  varying  widths.  Grids  with 
uniform  cell  widths  are  also  permitted.  Procedures  for  constructing  a  grid 
are  presented  in  documentation  of  package  CMSGRID  (Appendix  A  of  this  manual). 
CMSGRID  guidelines  for  grid  generation  pertain  to  hydrodynamic  models.  If 
model  SPH  is  intended  to  supply  wind-field  data  to  a  hydrodynamic  model,  the 
grids  for  model  SPH  and  the  hydrodynamic  models  must  be  identical.  CMS  does 
not  have  the  capability  to  interpolate  wind- field  data  from  one  rectilinear 
grid  to  another  or  from  one  grid  type  to  another.  If  model  SPH  output  data  are 
not  intended  for  input  into  a  hydrodynamic  model,  the  grid  cell  size  restric¬ 
tions  can  be  relaxed  (i.e.,  larger  cell  sizes,  on  the  order  of  lmile,  are 
allowed) .  Guidelines  for  overall  grid  dimensions  and  grid  alignment  are  the 
same  for  model  SPH  as  for  WIFM.  Sufficient  detail  of  landform/bathymetry  must 
be  provided  for  accurate  calculation  of  wind  fields  influenced  by  over-land 
friction  effects. 

38.  Selection  of  grid  coordinate  systems  is  controlled  by  variable 
GRTYPE  on  record  GRIDSPEC.  A  uniform,  or  constant,  grid  cell  size  is  selected 
by  assigning  the  character  string  RECTANG  to  variable  GRTYPE,  whereas  string 
RSTRETCH  selects  a  stretched  rectilinear  grid.  If  the  stretched  grid  option 
is  selected,  record  GRIDSPEC  must  be  followed  by  a  set  of  XSTRETCH  and 
YSTRETCH  records  (Table  3-3).  These  records  are  generated  by  the  interactive 
grid  generation  program  MAPIT  contained  in  package  CMSGRID  and  can  be  placed 
directly  into  the  input  data  set  without  modification.  The  reader  can  refer 
to  Appendix  A  for  more  information  on  XSTRETCH  and  YSTRETCH. 

39.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  computational  grid.  Valid  units  are  ENGLISH  or  METRIC.  Model  SPH  will 
convert  the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 
Variables  XCELLS  and  YCELLS  specify  the  number  of  grid  cells  in  the  x-  and  y- 
direction,  respectively.  Variables  DX  and  DY  on  record  GRIDSPEC  specify  a 
grid's  spatial  mapping  scale  in  the  x-  and  y-directions ,  respectively.  For 
uniform  grid  cells,  these  variables  are  assigned  the  physical  width  of  a 
single  cell.  For  stretched  rectilinear  grids,  the  variables  DX  and  DY  are 
assigned  the  value  1.0  if  physical  distances  were  used  in  generating  the  grid. 
The  variables  DX  and  DY  are  assigned  the  value  of  the  map  scale  if  relative 
map  distances  were  used  in  generating  the  grid.  As  an  example,  a  map  with  a 
scale  of  1:10,000  is  used  to  generate  a  stretched  rectangular  grid.  If  the 
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physical  distances  (i.e.,  grid  distances  on  the  10,000-ft  scale)  are  used  to 
generate  the  mapping  coefficients,  then  DX  and  DY  are  1.0  because  no  conver¬ 
sion  of  units  is  necessary.  However,  if  the  map  distances  (i.e.,  grid 
distances  measured  in  map  inches)  are  used  to  generate  the  mapping  coeffi¬ 
cients,  then  DX  and  DY  are  120,000  to  convert  map  inches  to  physical  distances 
(in  feet) . 

40.  Variables  GLATT  and  GLONG  specify  the  latitude  and  longitude  of  the 
grid  origin  in  decimal  degrees,  respectively.  GALIGN  specifies  the  counter¬ 
clockwise  rotation  of  the  x-axis  from  due  east  (in  decimal  degrees). 

Table  3-3 

Sample  XSTRETCH  and  YSTRETCH  Records 


XSTRETCH 

XSTRETCH 

XSTRETCH 

YSTRETCH 


1 

4 

9 

1 


4  -.696333695 
9  -6.69031772 
19  .143110486 

17  -.500000000 


.696333695 
5.80606023 
.710267924 
. 500000000 


.933460501 
.277821490 
.770050578 
1 . 00000000 


Physical  Characteristics 


41.  Each  grid  cell  must  be  assigned  a  water  depth  or  land  elevation. 
Topography /bathymetry  data  are  referenced  relative  to  an  arbitrary  datum. 
Typically,  the  map  datum  from  which  the  depths  are  taken  is  used.  Water  cells 
are  designated  by  negative  values  and  land  cells  have  positive  values. 

42.  One  BATHSPEC  record  is  required  for  defining  the  general  character¬ 
istics  of  the  topography /bathymetry  array  and  must  precede  this  array. 

Variable  BUNITS  defines  the  units  of  topography /bathymetry  data.  Valid  units 
are  feet,  meters,  or  fathoms.  The  input  sequence  for  reading  this  array  is 
controlled  by  variable  BSEQ.  Eight  options  for  the  input  sequence  are 
available  for  reading  the  array  data  and  are  given  in  Table  3-4.  For  the 
first  input  sequence  (Figure  3-16),  the  depths  are  read  along  the  x-direction, 
then  y  is  incremented  to  a  value  2,  and  again  the  sweep  in  the  x-directior 
takes  place.  This  procedure  is  repeated  until  the  entire  array  of  data  is 
read.  The  input  format  for  reading  this  array  can  be  selected  by  the  user 
with  variable  BFORM. 
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Table  3-4 


Input  Sequence  for  Array  Data 


Ha 

Sequence 

Description 

l 

XY 

1 

DO  1  J-l , YCELLS 

READ (LUN, FORM)  (VAR(I , J) , 1-1 .XCELLS) 

2 

-XY 

2 

DO  2  J-l, YCELLS 

READ (LUN, FORM)  (VAR(I , J) , I-XCELLS ,1,-1) 

3 

X-Y 

3 

DO  3  J-YCELLS , 1 , - 1 

READ (LUN, FORM)  (VAR(1 ,J) , 1-1 .XCELLS) 

4 

-X-Y 

4 

DO  4  J-YCELLS, 1, -1 

READ ( LUN , FORM)  ( VAR ( I , J ) , I-XCELLS ,1,-1) 

5 

YX 

5 

DO  5  1-1, XCELLS 

READ (LUN, FORM)  (VAR(I ,J) , J-l .YCELLS) 

6 

-YX 

6 

DO  6  1-1, XCELLS 

READ (LUN, FORM)  (VAR(I,J) , J-YCELLS , 1 , -1) 

7 

Y-X 

7 

DO  7  I-XCELLS , 1 ,- 1 

READ (LUN .FORM)  (VAR( I ,J) , J-l .YCELLS) 

8 

-Y-X 

8 

DO  8  I-XCELLS, 1, -1 

READ (LUN, FORM)  (VAR(I,J) , J-YCELLS , 1 , -1) 

Figure  3-16.  Input  sequence  -  option  1 


43.  The  maximum  water  depth  is  specified  with  variable  DLIMIT,  and  any 
array  values  deeper  than  DLTMIT  are  set  to  DLIMIT  (in  BUNITS) .  Grid-wide 
adjustments  to  land  elevations  contained  in  the  topography/bathymetry  array 
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can  be  made  with  variable  LDATUM.  The  value  assigned  to  this  variable  is 
added  to  all  land  cells  in  the  grid.  Positive  LDATUM  values  will  increase 
land  elevations,  whereas  negative  values  will  decrease  elevations.  Similarly, 
grid-wide  adjustments  to  water  depths  can  be  made  with  variable  WDATUM.  The 
value  assigned  to  this  variable  is  added  to  all  water  cells.  Since  these 
cells  have  negative  values,  positive  WDATUM  values  produce  shallower  basins. 

44.  Changes  to  the  topography /bathymetry  array  can  also  be  made  to 
individual  cells,  or  a  group  of  cells  with  record  CHNGBATH.  This  record 
allows  the  user  to  quickly  change  values  assigned  to  the  bathymetry  array 
without  editing  the  array  itself.  It  should  be  noted  that  values  of  variable 
BATH  on  the  CHNGBATH  record  are  assumed  to  have  units  consistent  with  those 
selected  for  bathymetry/topography  (i.e.,  variable  BUNITS  on  record  BATHS PEC ) . 
Variables  X1INDX  and  X2INDX  on  the  CHNGBATH  record  specify  the  minimum  and 
maximum  cell  numbers  in  the  x- direction,  respectively,  where  the  bathymetry/ 
topography  value  will  change.  Similarly,  variables  Y1INDX  and  Y2INDX  on  the 
CHNGBATH  record  specify  the  minimum  and  maximum  cell  numbers  in  the  y- 
direction,  respectively,  where  the  bathymetry/topography  value  will  change. 

Wind-Field  Specif l cation 


45.  Hurricanes  can  have  a  constant  or  variable  translational  direction. 
The  constant  translation  option  is  normally  selected  for  computing  the 
Standard  Project  Hurricane  wind  fields.  The  variable  translation  option  is 
provided  to  allow  the  user  to  replicate,  or  hindcast,  wind  fields  produced  by 
historical  hurricane  events.  One  WINDSPEC  record  and  one  SPHSPEC  record  is 
required  for  either  option.  In  addition,  constant  translation  storms  require 
one  TABSPH  record,  and  variable  translation  storms  require,  at  a  minimum,  two 
TABSPH  records.  Tirae(s)  specified  on  the  TABSPH  record(s)  are  referenced  to 
the  start  of  the  simulation,  which  is  0.0  hr  0.0  min  unless  the  hotstart 
option  is  chosen  with  the  STARTUP  record  (WIFM  applications  only) . 

Constant  translational  hurricane 

46.  A  constant  translation  storm  is  specified  with  the  WNTRVL  variable 
set  to  CONSTANT  on  the  WINDSPEC  record.  WTYPE  must  be  set  to  SPH.  The  units 
of  wind  input  values  (WUNITS)  and  the  atmospheric  pressure  input  values 
(PUNITS)  are  also  specified  on  the  WINDSPEC  record.  The  wind  field  can  be 
gradually  applied  from  quiescent  conditions  to  a  given  (or  interpolated)  value 


by  applying  a  spline  fit  over  a  time  period  specified  with  variable  WFETHR  on 
record  WINDSPEC.  The  constant  translational  hurricane  option  requires  the 
forward  speed  (VTRANS) ,  track  angle  (HTRACK) ,  atmospheric  pressure  at  the 
periphery  of  the  storm  (PRFPRS),  and  the  effective  radius  parameter  (RMAXE)  to 
be  specified  on  the  SPHSPEC  record.  Track  angles  are  measured  using  the 
standard  meteorological  convention:  an  angle  of  zero  degrees  defines  a 
hurricane  traveling  from  north  to  south,  and  that  angle  increases  in  the 
clockwise  direction.  For  example,  a  hurricane  traveling  from  east  to  west  has 
a  track  angle  of  90.0  deg.  Track  angles  should  not  be  adjusted  to  correspond 
to  the  computational  grid's  axes.  Models  SPH  and  WIFM  perform  this  task 
internally.  The  effective  radius  parameter  is  a  form  factor  that  adjusts  the 
radial  wind  distribution  for  historical  events.  The  effective  radius  is  equal 
to  the  radius  to  maximum  winds  for  the  SPH  storm. 

47.  The  TABSPH  record  is  used  to  specify  the  SPH  parameters  at  a  given 
instant  in  time  (SPHOUR, SPHMIN)  where  SPHOUR  is  in  hours  and  SPHMIN  is  in 
minutes.  The  TABSPH  record  contains  the  central  pressure  index  (CPI),  radius 
to  maximum  winds  (RMAX) ,  maximum  wind  speed  (MAXWND) ,  angle  to  maximum  winds 
(AZMUTH)  measured  clockwise  from  the  forward  velocity  vector  to  the  maximum 
wind  velocity  vector,  and  wind  inflow  angle  (NGRESS)  at  a  specified  time.  The 
landfall  point,  specified  by  variables  SPHLAT  and  SPHLNG  on  record  TABSPH,  is 
a  reference  point  that  the  eye  of  the  hurricane  will  pass  through.  Coupled 
with  the  track  angle,  these  parameters  define  the  path  of  the  hurricane.  The 
landfall  point  is  normally  assigned  a  latitude  and  longitude  within  the  study 
area.  However,  models  SPH  and  WIFM  permit  landfall  points  that  are  outside 
the  grid  limits.  This  feature  is  generally  used  when  applying  the  model  to  a 
historical  storm  event  and  will  be  discussed  in  the  next  section. 

48.  The  time  at  which  the  hurricane  reaches  the  landfall  point  (rela¬ 
tive  to  the  simulation  start  time)  is  specified  by  variables  SPHOUR  and  SPHMIN 
in  record  TABSPH.  It  is  more  convenient  to  specify  the  landfall  point  and 
corresponding  simulation  time  rather  than  specifying  the  starting  location  of 
the  hurricane.  Models  SPH  and  WIFM  compute  the  starting  location  internally. 

49.  As  previously  noted,  variable  DELT  is  the  time-step  for  saving 
wind- field  data  for  use  by  a  hydrodynamic  model  and  has  no  effect  on  the  SPH 
simulation  other  than  setting  the  other  time  variables.  The  times  at  which 
wind  fields  are  actually  computed  are  controlled  by  variable  SPHDLT  on  record 
SPHSPEC.  Usually,  wind  fields  are  not  computed  at  each  time-step  (i.e., 
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SPHDLT  is  larger  than  DELT) .  However,  models  SPH  and  WIFM  have  the  capability 
of  linearly  interpolating  wind- field  velocities  and  atmospheric  pressures  at 
time-steps  when  wind-field  calculations  are  not  made.  The  time  interval,  or 
frequency  at  which  wind  fields  are  interpolated,  is  controlled  by  variable 
WINTRP  in  record  WINDSPEC.  A  value  of  15.0  min  for  variable  SPHDLT  and  a 
5.0-min  value  for  variable  WINTRP  are  usually  sufficient  to  accurately  predict 
hurricane  wind  fields  for  slow-moving  storms.  However,  fast-moving  storms 
require  lower  values  to  accurately  represent  the  wind  fields. 

50.  The  three  time  variables  (DELT,  SPHDLT,  and  WINTRP)  are  related  in 

the  following  way:  values  for  variables  SPHDLT  and  WINTRP  must  be  integer 
multiples  of  the  time -step  (variable  DELT  on  record  TIMESPEC)  for  the  computa¬ 
tion/interpolation  scheme  to  work  properly.  For  example,  given  a  time -step, 
DELT,  of  1.0  min,  SPHDLT  equal  to  4.0  min,  and  WINTRP  equal  to  2.0  min,  wind- 
field  calculations  will  occur  at  simulation  times  of  0.0,  4.0,  8.0  min,  etc. 
Wind  velocities  and  atmospheric  pressures  will  be  interpolated  at  simulation 
times  2.0,  6.0,  10.0  min,  etc.  (Wind  fields  are  not  updated  at  simulation 

times  1.0,  3.0,  5.0  min,  etc.)  If  values  of  30.0  and  31.0  min  are  specified 
for  the  time -step  and  variable  WINTRP,  respectively,  wind  fields  will  be 
interpolated  at  930.0-min  intervals,  the  first  number  divisible  by  both  30 
and  31. 

Variable  translational  hurricane 

51.  A  variable  translation  storm  is  specified  with  WNTRVL  set  to 
VARIABLE  on  the  WINDSPEC  record.  All  other  variables  on  the  WINDSPEC  record 
are  the  same  as  described  for  a  constant  translation  storm.  A  variable 
translation  storm  requires  only  the  effective  radius  parameter  (RMAXE)  and  the 
atmospheric  pressure  at  the  storm's  periphery  (PRFPRS)  to  be  specified  on  the 
SPHSPEC  record. 

52.  The  first  TABSPH  record  for  the  variable  translation  option  must 
specify  the  wind- field  parameters  at  the  start  of  the  simulation.  Further¬ 
more,  the  last  TABSPH  record  must  specify  the  hurricane  parameters  no  earlier 
than  the  end  of  the  simulation.  For  example,  if  the  end  of  the  simulation  is 
at  time  12.0  hr  0.0  min,  the  time  specified  on  the  last  TABSPH  must  be  greater 
than  or  equal  to  12.0  hr  0.0  rain.  It  should  be  noted  that  for  variable 
translation  storms,  SPHLAT  and  SPHLNG  specify  the  latitude  and  longitude  of 
the  storm  eye  at  time  SPH0UR.SPHMIN,  rather  than  the  landfall  point  as  it  was 
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for  a  constant  translation  storm.  All  other  variables  on  the  TABSPH  record 
are  the  same  as  described  for  a  constant  translation  storm. 

53.  Wind  fields  are  computed  only  at  times  specified  with  the  TABSPH 
records.  Models  SPH  and  WIFM  do  not  compute  wind  fields  at  intermediate  time 
intervals  when  the  variable  translation  option  is  chosen.  However,  wind 
fields  can  be  interpolated  at  intermediate  time-steps  (WINTRP) .  The  procedure 
for  selecting  the  wind- field  interpolation  option  was  explained  in  the 
preceding  section. 


Output  Specification 

54.  Model  SPH  provides  several  options  for  displaying  output,  includ¬ 
ing:  numerical  gage  time-histories  at  selected  grid  cells;  wind-field  vectors 

at  user-specified  times  during  a  simulation;  and  an  output  listing  containing 
an  input  data  summary  and  a  printout  of  wind  velocity  and  atmospheric  pressure 
fields.  Wind  and  pressure  data  files  can  be  used  as  input  to  hydrodynamic 
models  as  well  as  wave  hindcast  models.  Data  can  be  displayed  in  either 
tabular  or  graphical  form  with  the  post-processing  package  CMSPOST  discussed 
in  Appendix  D. 

55.  The  output  listing  containing  a  summary  of  the  input  data  set  is 
generated  for  every  simulation.  Error  and  warning  diagnostic  messages  are 
also  contained  in  this  listing.  A  sample  output  listing  containing  a  summary 
of  the  input  dataset  is  presented  in  Figure  3-17. 

56.  Each  record  is  summarized  in  tabular  form  with  a  heading  containing 
its  record  identification  label  followed  by  a  brief  description  of  that 
record's  function.  A  table  is  composed  of  each  variable's  name,  a  description 
of  that  variable  (including  its  units,  when  applicable),  and  an  error  diagnos¬ 
tic  note. 

57.  Model  SPH  contains  error  diagnostic  features  that  inspect  an  input 
data  set  for  possible  errors.  These  features  include:  comparing  an  inputted 
value  against  a  range  of  quantities  that  are  representative  for  that  variable; 
checking  for  misspelled  character  data;  and  checking  for  missing  data.  The 
error  diagnostic  note  can  be  assigned  three  strings,  which  are  "FATAL,"  for 
errors  where  the  model  cannot  execute  given  the  value  supplied;  "WARN,"  for 
data  outside  the  range  of  values  typically  selected  for  that  variable;  and  a 
null  string  for  instances  where  an  error  condition  has  not  been  identified. 
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Test  No.  l:  SPH  Star* 


*****  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE:  VALUE: 


SUNITS  UNITS  SYSTEM  USED  IN  COMPUTATIONS  ENGLISH  • 


*****  8RIDSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINITE— DIFFERENCE  GRID  USED 


VARIABLE 

DESCRIPTION  S  USAS: 

VALLE:  NOTES:  •  VARIABLE 

DESCRIPTION  S  USAS: 

VALUE: 

GRTYPE 

TYPE  S  FINITE-DIFFERENCE  SID 

RECTANG  *  SUNITS 

SYSTEM  S  SITS  USED  FS  DC  SID 

EMLISH 

XCELL 

NUMBER  S  SID  CELLS.  X  DIRECTION 

26  •  YCELL 

NUMBER  S  SID  CEILS.  Y  DIRECTION 

24 

OX 

SPATIAL  STEPSIZE  IN  X  DIRECTION 

38216.30  *  DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTION 

38216.30 

GLATT 

GALIGN 

LATITUDE  S  SIO  SIGIN  (DEGREES) 
SID  ROTATION  FS  EAST  (DESEES) 

28.48  *  GLONG 

340.00  * 

LONGITUDE  S  SIO  SIGIN  (DESEES) 

92.10 

*****  TIIESPEC  CARD:  SPECIFICATION  OF  COMPUTATIONAL  TIME  UNITS 


VARIABLE 

DESCRIPTION  S  USAS: 

VALUE: 

NOTES:  *  VARIABLE 

DESCRIPTION  S  USAS: 

VALUE: 

DELT 

COMPUTATIONAL  TIME  STEP  (SECONDS) 

900.0 

*  TUNITS 

Tire  (KITS  FS  ALL  IWUT  VARIABLES 

MINUTES 

TPROV 

TIK  AT  START  S  MODEL  SIMULATION 

0.0 

«  TMAX 

TOTAL  TIS  S  SIMULATION 

3600.0 

DTGAGS 

TIME  INTERVAL  TO  SAVE  GAS  DATA 

IS.  00 

*  DTHOTS 

Tire  INTERVAL  TO  SAVE  KJTSTARTS 

3600.00 

•*•••  HYDROGRAPH  AND  VELOCITY  MEASUREMENTS:  3  SAGES 

GAGE  GAGE-POSITION  VELOCITY-tCASUREHENT 


NUMBER: 

X  Y  NOTES: 

TYPE:  NOTES: 

GAS  name: 

I 

5  17 

UAVGVAVG 

SUBKRGED  PIPE  LOCATION 

2 

10  17 

UAV6VAV6 

DUf>  SITE  LOCATION 

3 

15  17 

UAVGVAVG 

MARSH  ISLAM)  LOCATION 

*****  TIMES  FOR  SNAPSHOTS  OF  OATA  SAVED  (HINUTES  >: 


600.000 

1200.000 

2400.000  3600.000 

*♦♦»«  PRINTING 

OF  FIELD  ARRAY  VARIABLES:  1 

AREAS 

AREA  • 

STARTING 

ENDING 

STARTIN6 

ENHNG 

• 

TIMES  TO  PRINT 

(HINUTES  ):  * 

VARIABLE 

FIELD 

NUMBER  ♦ 

-  —  • 

X  CELL 

X  CELL 

Y  CELL 

Y  CELL  NOTES: 

*  START  AT 

END  AT 

INTERVAL  NOTES:  * 

ARRAYS  TO 

PRINT: 

w 

1  * 

X=  1 

X=  26 

Y=  1 

Y=  24 

• 

0.0 

3600.0 

1.0  • 

HP 

*****  wrosPEC 

CARD:  SPECIFICATION  OF  DC  MIND  FIELD  - 

VARIABLE  DESCRIPTION  OF  USAS:  VALUE:  NOTES:  •  VARIABLE  DESCRIPTION  S  USAS:  VALUE: 


Figure  3-17.  Sample  output  listing 


NOTES: 


NOTES: 


notes: 


notes: 


notes: 
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Although  this  model  contains  error  diagnostic  capabilities,  the  user  should 
thoroughly  inspect  the  input  data  summary  to  ensure  that  the  data  are  correct. 

58.  Field  arrays  (e.g.,  bathymetry,  atmospheric  pressure,  and  wind 
velocity)  are  printed  along  with  the  input  data  summary  by  including  one  or 
more  PRWINDOW  records.  The  user  can  control  printing  of  field  arrays  through 
the  course  of  a  simulation  by  specifying  the  starting  (WPRSTR)  and  ending 
(WPREND)  times,  together  with  the  time  interval  (WPRINT) ,  at  which  the  data 
will  be  printed.  Furthermore,  the  user  can  specify  printing  of  subgrid 
regions,  as  opposed  to  the  entire  grid  if  they  so  choose.  This  is  done  by 
specifying  the  x-  and  y-boundaries  of  the  subgrid  region  with  variables 
WXCEL1 ,  WXCEL2 ,  WYCEL1,  and  WYCEL2 . 

59.  Gage  time-histories  of  wind  velocity  and  atmospheric  pressures  are 
saved  with  record  RECGAGE.  One  RECGAGE  record  is  required  for  each  desired 
output  location  where  both  the  wind  velocity  and  the  atmospheric  pressure  are 
to  be  saved.  A  maximum  of  120  gages,  each  containing  up  to  1,000  points,  can 
be  processed.  All  gage  time-histories  are  stored  in  one  file  and  are  pro¬ 
cessed  by  programs  HYDADD,  HYDLST,  and  HYDPLT  in  package  CMSPOST. 

60.  Variables  GXPOS  and  GYP0S  on  record  RECGAGE  define  the  grid 
location  where  wind  velocity  and  atmospheric  pressures  are  saved.  The  time 
interval  at  which  these  data  are  stored  is  controlled  by  variable  DTGAGS  on 
record  TIMESPEC.  Variable  GTYPE  on  record  RECGAGE  is  only  applicable  to 
averaging  water  velocities  generated  by  model  WIFM  and  does  not  affect  output 
from  model  SPH. 

61.  Record  RECSNAPS  allows  the  user  to  store  wind  velocity  and  atmo¬ 
spheric  pressure  data  for  generating  vector  plots.  The  stored  data  can  also 
be  used  as  input  to  other  models.  Data  can  be  saved  at  regular  time  intervals 
(SNPTYP  -  INTERVAL),  at  specific  times  during  a  simulation  (SNPTYP  -  TIMES), 
or  both;  however,  all  time  indices  must  be  integer  multiples  of  the  time -step, 
DELT.  More  than  one  RECSNAPS  record  can  be  used,  and  up  to  100  snapshots  can 
be  saved  in  a  file.  These  data  can  be  processed  with  programs  SNAPCON, 

SNAPLST ,  and  SNAPVEC,  which  reside  in  package  CMSPOST. 
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PART  V:  DEFINITION  OF  INPUT  DATA  FORMAT 


62.  The  input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  models  released  by  the  US  Army  Engineer  Hydrologic 
Engineering  Center.  It  is  the  intent  that  this  structure,  being  familiar  to 
Corps  personnel,  will  reduce  the  time  needed  to  learn  this  system.  The 
general  format  of  the  input  data  set  records,  where  a  record  refers  to  one 
line  of  data,  is  presented  below: 

g.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

b.  Field  1,  columns  1  through  8,  contains  a  mnemonic  identifi¬ 
cation  label  that  describes  the  purpose  or  function  of  each 
record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right  justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  do  not  need  to  be  right-  or  left- 
justified. 

4.  Array  data,  such  as  depths,  are  read  with  DO  or  Implied  DO 

loops .  No  label  is  required  for  each  record  containing  array 
data.  However,  a  general  specification  record  such  as  BATH- 
SPEC,  which  defines  bathymetric  attributes,  must  precede  that 
array . 

63.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution  or  bypassing  of  desired 
user-defined  operations,  such  as  saving  time-history  data. 

64.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  simulation  or  required  by  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies  per¬ 
formed  by  CERC.  Although  these  quantities  may  not  be  applicable  to  all 
studies,  they  can  serve  as  a  guide  when  selecting  replacement  values. 

65.  Default  values  are  processed  when  the  record  field  corresponding  to 
that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving  fields 
blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a  variable 
being  assigned  a  value  of  zero.  These  variables  and  their  respective  default 
values  are  noted  in  Appendix  3 -A.  The  following  discussion  pertains  to  the 
general  format  of  the  input  records  given  in  Appendix  3-A. 
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66.  Each  record  is  presented  in  a  standardized  tabular  format  and  has 
as  its  heading  the  mnemonic  identification  label  or  name  with  a  brief  descrip¬ 
tion  of  its  function.  Following  its  name,  the  record  has  an  abbreviated  note 
documenting  whether  it  is  required  for  a  simulation.  These  abbreviations  have 
the  following  definitions: 

Record  or  variable  is  required  for  each  simulation. 


(Req) 

(Opt) 

(C-opt) 


Record  or  variable  is  optional.  Omitting  this  item  results 
in  either  the  default  value  being  used  or  the  defined  oper¬ 
ation  not  being  performed. 

Record  or  variable  is  required  if  related  or  parent  options 
have  been  selected. 


For  example,  record  TIMESPEC,  presented  in  Appendix  3 -A,  contains  the  note 
(Req) ,  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt)  meaning  this  record  is 
optional  and  is  used  only  when  changes  to  the  bathymetric  data  are  desired. 
Record  XSTRETCH  contains  the  note  (C-opt) ,  meaning  this  record  is  required 
only  if  a  stretched  Cartesian  grid  has  been  specified  on  the  GRIDSPEC  record. 

67.  Input  variables,  presented  in  column  2  of  each  table,  are  refer¬ 
enced  to  their  respective  record  fields  shown  in  column  1.  Generally,  data 
for  each  variable  occupy  a  single  8-column  data  field.  However,  variables 
assigned  titling  or  formatting  information  can  occupy  several  fields. 

68.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  column  3,  and  can  be  real,  integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up  to  16 

characters 

Char*8  Alphanumeric  character  string  containing  up  to  8  char¬ 

acters 

Integer  Integer  data 

Real  Real  (floating  point)  data 

69.  Column  4  of  each  table  defines  whether  the  respective  variable  must 
be  assigned  a  value.  Abbreviations  listed  in  this  column  have  identical 
meanings  as  those  for  the  records.  Default  values  are  listed  in  column  3.  A 
blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 
assigned  a  default  value. 
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70.  Column  6  of  each  table  lists  the  variables'  permitted  data  type  or 
all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 
specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+1  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 

71.  Variable  definitions  are  listed  in  column  7  of  each  table. 
Variables  whose  quantities  are  unit -dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  TMAX  is 
assigned  a  value  having  units  defined  by  variable  TUNITS.  Variables  defining 
input  data  units,  and  on  which  record  they  reside,  are  presented  below. 


Variable 

Record 

BUNITS 

BATHSPEC 

bathymetry/topography  data 

GUNITS 

GRIDSPEC 

numerical  grid  data 

PUNITS 

WINDSPEC 

atmospheric  pressure  data 

SUNITS 

GENS PECS 

model  computations  and  output 

TUNITS 

TIMESPEC 

time -dependent  variables 

WUNITS 

WINDSPEC 

wind  velocity  data 
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PART  VI:  TEST  PROBLEMS 


72.  This  section  contains  two  test  problems  that  demonstrate  model 
capabilities  and  serve  as  a  guide  in  developing  an  input  data  set.  The  first 
problem  is  an  example  of  an  SPH  simulation,  and  the  second  is  a  hindcast 
simulation  of  Hurricane  Danny,  which  struck  the  Louisiana  coast  in  August 
1985.  Each  example  is  applied  to  the  same  study  site  (Figure  3-18)  and  uses 
the  same  computational  grid  (Figure  3-19).  Two  simplifications  were  made 
while  constructing  this  grid  so  that  the  model's  capabilities  could  be  clearly 
presented.  These  simplifications  are  (a)  limiting  the  grid's  reach  in  the 
seaward  direction  and  (b)  minimizing  the  number  of  cells  covering  the  study 
area.  How  these  factors  affect  a  study  are  explained  later  in  this  section. 

73.  The  grid  extends  in  the  longshore  direction  from  Upper  Mud  Lake  to 
East  Cote  Blanche,  Louisiana.  The  grid's  northern  boundary  was  chosen  so  that 
Grand  Lake  and  Vermilion  Bay  are  included  in  the  model,  and  the  southern 
boundary  extends  to  a  water  depth  of  approximately  22  fathoms. 

74.  The  grid's  origin  was  arbitrarily  chosen  at  its  southwest  corner. 
(Any  of  the  four  corners  can  be  chosen  as  the  origin.)  Thus,  the  x-axis 
corresponds  with  the  longshore  axis,  and  the  y-axis  extends  in  the  landward 
direction.  Total  grid  lengths  in  the  x-  and  y-directions  are  163.4  and 
150.9  n.  m. ,  respectively. 

75.  The  grid  is  aligned  at  an  angle  of  340.0  deg,  measured  counter¬ 
clockwise  from  east  to  the  x-axis.  At  this  angle,  the  x-axis  roughly  paral¬ 
lels  the  shoreline,  providing  a  smooth  representation  of  the  land-water 
interface.  Alignments  that  produce  jagged,  "saw-tooth"  shorelines  should  be 
avoided  because  surface  friction  effects  would  not  be  properly  imposed  on  the 
wind  field. 

76.  For  storm  surge  analyses  performed  with  a  hydrodynamic  model,  the 
grid  should  extend  to  the  seaward  edge  of  the  continental  shelf.  To  simulate 
the  combined  effects  of  tide  and  pressure  anomaly,  the  hydrodynamic  model  adds 
the  two  components  at  the  outer  seaward  boundary.  This  linear  superposition 
procedure  is  most  valid  in  deep  water  since  the  tidal  signal  is  attenuated, 
primarily  due  to  bottom  friction,  in  shallow  water.  Hence,  if  the  grid  was 
constructed  for  an  actual  study,  it  would  extend  to  a  water  depth  of  at  least 
300  ft. 
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Figure  3-18.  SPH  study  site:  Coast  of  Louisiana 


77.  The  grid  is  composed  of  26  cells  in  the  x-direction  and  24  cells  in 
the  y-direction,  with  each  cell  measuring  38,216.3  by  38,216.3  ft.  Because  of 
the  large  cell  dimensions,  this  grid  is  too  coarse  for  use  in  a  hydrodynamic 
model.  Greater  resolution  is  needed,  particularly  in  the  bay  areas,  to 
accurately  represent  the  hydraulic  features  influencing  currents  and  water 
levels.  Typically,  a  grid  used  in  a  hydrodynamic  model  would  have  cell  widths 
of  100  to  500  ft  in  channel  and  inlet  areas,  and  cell  widths  of  approximately 
10,000  ft  along  the  outer  seaward  boundary.  Additional  guidance  in  generating 
grids  is  contained  in  Appendix  A. 

Test  Problem  1 


78.  This  problem  illustrates  the  simulation  of  an  SPH  storm  whose 
landfall  point  is  latitude  29.6  deg  N  and  longitude  92.7  deg  W.  From  Fig¬ 
ure  3-6,  this  location  is  at  milepost  450  n.  m.  The  SPH  parameters  for  this 
location  are: 

a.  Peripheral  pressure  is  equal  to  29.77  in.  Hg. 

b.  Central  pressure  is  equal  to  27.37  in.  Hg  (Figure  3-7). 

c.  Forward  speed  is  equal  to  25.0  knots  (Figure  3-8). 

d.  Radius  to  maximum  winds  is  equal  to  20.0  n.  m.  (Figure  3-9). 

e.  Inflow  angle  is  equal  to  7.5  deg  (Figure  3-10). 

f.  Track  angle,  for  category  B  (Table  3-1),  is  equal  to  140.0  deg 
(Figure  3-11). 

g.  Air  density  coefficient,  K  ,  is  equal  to  67  (Figure  3-12). 

h.  Maximum  rotational  wind  speed  is  equal  to  101.20  knots  (Equa¬ 

tion  3-20) . 

79.  Figures  for  the  parameter's  forward  speed,  radius  to  maximum  winds, 
and  track  direction  contain  a  range  of  suitable  values.  Choosing  the  maximum 
value  for  each  particular  parameter  does  not  guarantee  that  the  predicted  wind 
fields  will  generate  the  maximum  storm  surge  level.  Several  parameter  combi¬ 
nations  must  be  tested  when  performing  a  storm  surge  analysis  to  ensure  that 
the  maximum  storm  surge  level  has  been  obtained. 

80.  This  test  problem's  input  data  set  is  presented  in  Table  3-5. 

Three  time-series  graphs,  showing  wind  magnitude  and  direction,  and  atmos¬ 
pheric  pressure  anomalies  are  presented  in  Figures  3-20  through  3-22.  The 
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simulation's  input  data  summary  is  presented  in  Table  3-6.  Vector  wind-field 
graphs  are  presented  in  Figures  3-23  through  3-25. 


GENSPECS 

Test  No.  1 

:  SPH 

Storm 

ENGLISH 

TIMESPEC 

900.0 

MINUTES 

0.0 

3600.0 

15.0 

GRIDSPEC 

PRWINDOW 

RECTANG 

ENGLISH 

26 

24 

38216.3 

38216.3 

28.48 

92.10 

340.0 

RECGAGE 

5 

17 

SUBMERGED 

i  PIPE  LOCATION 

RECGAGE 

10 

17 

DUMP  SITE 

!  LOCATION 

RECGAGE 

15 

17 

MARSH  ISLAND  LOCATION 

RECSNAPS 

TIMES 

600. 

1200 

2400 

3600 

WINDSPEC 

SPHCONSTANT 

KNOTSMILLIBAR 

5.0 

SPHSPEC  1014.000 

40.0 

120.0 

135.0 

12.0 

TABSPH 

40. 

30. 

29.6 

92.7 

987.00 

40.0 

80.0 

180.0 

29.0 

BATHSPEC 

YX 

(6X.9F8.1) 

1 

-14.0 

-14.0 

-13.0 

-13.0 

-13.0 

-13.0 

-12.0 

-9.0 

-10.0 

-9.0 

-9.0 

-7.8 

-8.0 

-7.5 

-7.5 

-6.5 

-5.8 

-4.5 

-2.0 

.33 

.667 

1.0 

1.33 

1.5 

2 

-16.0 

-15.0 

-14.0 

-12.0 

-12.0 

-13.0 

-12.0 

-9.0 

-10.0 

-9.0 

-9.0 

-9.0 

-8.0 

-8.0 

-8.0 

-6.5 

-6.3 

-3.5 

-2.0 

.33 

.667 

1.0 

1.33 

1.5 

3 

-17.0 

-15.0 

-14.0 

-12.0 

-12.0 

-13.0 

-13.0 

-11.0 

-9.0  ^ 

-10.0 

-10.0 

-9.0 

-9.0 

-8.0 

-8.0 

-6.5 

-6.0 

-4.0  Al 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

4 

-18.0 

-15.0 

-14.0 

-13.0 

-12.0 

-13.0 

-13.0 

-12.0 

-10.0 

-10.0 

-10.0 

-9.0 

-8.0 

-8.0 

-8.0 

-6.5 

-5.0 

-3.0 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

5 

-17.0 

-15.0 

-14.0 

-13.0 

-12.0 

-13.0 

-13.0 

-13.0 

-11.0 

-9.0 

-10.0 

-9.0 

-9.0 

-8.0 

-7.5 

-6.5 

-5.0 

-2.5 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

6 

-17.0 

-16.0 

-14.0 

-14.0 

-13.0 

-13.0 

-13.0 

-13.0 

-12.0 

-10.0 

-10.0 

-9.0 

-9.0 

-9.0 

-7.5 

-6.8 

-5.0 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

1.833 

7 

-17.0 

-16.0 

-16.0 

-15.0 

-14.0 

-13.0 

-14.0 

-13.0 

-12.0 

-11.0 

-10.0 

-9.0 

-9.0 

-8.0 

-7.5 

-6.0 

-5.0 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

1.833 

8 

-17.0 

-17.0 

-16.0 

-15.0 

-14.0 

-13.0 

-14.0 

-13.0 

-12.0 

-11.0 

-10.0 

-9.0 

-9.0 

-8.0 

-7.0 

-6.0 

-3.0 

.33 

.667 

1.0 

1.33 

1.5 

1.667 

1.833 
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DUf  SITE  L0CKI10K 
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Figure  3-21.  Test  1  hydrograph  for  gage 


Figure  3-22.  Test  1  hydrograph  for  gage 


Table  3-6 


Input  Data  Summary  for  Test  1 


Test  No.  t:  SPH  Store 


•••••  6ENSPCCS  CARD:  SPECIFICATION  Of  TITLE  AND  KIERAL  SYSTEM  OF  UNITS 


variable 

DESCRIPTION  OF  USAGE: 

value: 

NOTES:  •  VARIABLE  DESCRIPTION  OF  USAGE: 

value: 

SUN1TS 

UNITS  SYSTEM  USED  IN  aWtlTATIONS 

ENGLISH 

* 

•••••  GRIDSPEt  CARD:  SPECIFICATION  OF  T>€  TYPE  OF  FINITE-DIFFERENCE  GRID  UGEO 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  <  VARIABLE  DESCRIPTION  OF  USAGE: 

value: 

GRTYPE 

TYPE  OF  FINITE-DIFFHSNCE  GRID 

RECTANG 

•  GUNITS 

SYSTEM  OF  WITS  USED  FOR  TIE  GRIO 

EMGL1S) 

KELL 

NHER  OF  GRID  CELLS,  I  DIRECTION 

24 

*  YCELL 

NICER  OF  GRID  CELLS.  Y  DIRECTION 

24 

m 

SPATIAL  STEPSIZE  IN  I  DIRECTION 

38214.30 

•  OY 

9PATIAL  STEPSIZE  IN  Y  DIRECTION 

38214.30 

BUTT 

UTITDOE  OF  GRID  ORIGIN  (DEGREES) 

28.46 

•  (LONG 

LONGITUDE  OF  GRID  ORIGIN  (DEGREES) 

92.10 

6ALIGN 

GRID  ROTATION  FOR  EAST  (DEGREES) 

340.00 

« 

4*444  TINESPEE  CARD:  SPECIFICATION  OF  COWUTATKWAL  TIME  UNITS 

VARIABLE 

OESCRIPTItK  OF  USAGE: 

VALUE:  NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

BELT 

OHVTATKMAL  TIRE  STEP  (SEEOWSI 

900.0 

4  UNITS 

TIIE  WITS  FOR  At i  INPUT  VARIABLES 

IONITES 

TPROV 

TIIE  AT  START  OF  HOOEL  SIMULATION 

0.0 

•  THAI 

TOTAL  TIME  OF  SUUATION 

3600.0 

DTGAGS 

THE  INTERVAL  TO  SAW  GAGE  OATA 

15.00 

•  oners 

THE  INTERVAL  TO  SAVE  HOTSTARTS 

3400.00 

KYDROBWH  m  VELOCITY  HEASURE1ENTS:  3  GASES 


BASE  GASE -POSITION 

TAKER:  l  Y  NOTES: 


1  S  17 

2  10  17 

3  IS  17 


VELOCITY -ICASUROEXT 
TYPE:  NOTES: 


UAVBVAVG 

UAWVAVG 

WWOWTJ 


BASE  NIK: 


SUKNOEI  PIPE  LOCATION 
HIP  SITE  LOCATION 
HARSH  ISLAND  LOCATION 


•••••  TIIES  FOR  SNAPSHOTS  OF  DATA  SAVED  IH1NUTES  ): 
400.000  1200.000  2400.000  3600.000 


44444  PRINTING 

OF  FIELD  ARRAY  VARIABLES:  I 

AREAS 

AREA  4 

STARTING 

ENDIN6 

STARTING 

EWING 

4  TINES  TO  PRINT 

(MINUTES  >: 

• 

VARIABLE  FIELD 

NICER  4 

...  — .  f 

I  CELL 

1  CELL 

YCHJ. 

Y  CELL  NOTES: 

•  START  AT 

END  AT 

INTERVAL  NOTES: 

• 

ARRAYS  TO  PRINT: 

l  4 

J*  1 

24 

Y*  l 

Y*  24 

4  0.0 

3400.0 

1.0 

*  • 

• 

NP 

*•444  NIWSPEC  CARD:  SPECIFICATION  OF  THE  HIM)  FIELD  - 

VARIAHE  RESCRIPT  IW  OF  USAGE:  VALUE:  NOTES:  «  VARIABLE  DESCRIPTION  OF  USAGE:  VALUE: 


i 


NOTES: 


notes: 


NOTES: 


NOTES: 


MITES: 
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Test  No.  Is  SPH  Storm 


HINO  VECTORS  SIMULATION  TIME:  20.00 HOURS 


Figure  3-23.  Test  1  wind-field  snapshot  at  hour  20 
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Test  No.  is  SPH  Storm 


WIND  REFERENCE  LENGTH:  60.00  KNOTS 


Figure  3-24.  Test  1  wind-field  snapshot  at  hour  40 


HIND  REFERENCE  LENGTH:  60.00 


KNOTS 


Figure  3-25.  Test  1  wind- field  snapshot  at  hour  60 


81.  This  problem  Is  a  hindcast  simulation  of  Hurricane  Danny,  which 
struck  the  Louisiana  coast  in  August  1985.  Figure  3-26  illustrates  the 
approximate  track  of  Danny  as  it  traveled  across  the  Gulf  of  Mexico  and  the 
southern  United  States.  Hurricane  data  used  in  this  example  were  obtained 
from  Garcia  and  Hegge  (1987). 

82.  The  simulation  began  at  0000  Greenwich  mean  time  (GMT)  14  August 
1985  and  concluded  60  hr  later  at  1200  16  August  1985.  Hurricane  Danny 
reached  landfall  at  approximately  1630  15  August  1985,  or  at  simulation  time 
40  hr.  The  simulation  was  started  40  hr  before  landfall  so  that  if  a  hydrody¬ 
namic  model  were  used  to  study  the  resulting  storm  surge,  the  model  would  have 
sufficient  time  in  which  to  develop  accurate  circulation  fields.  In  addition, 
starting  with  low  wind  velocities  would  prevent  the  formation  of  artificial 
waves  induced  by  shocking  the  model  with  high  wind  velocities. 

83.  For  the  first  18  hr  during  the  simulation,  Danny  was  classified  as 
a  tropical  storm  with  wind  speeds  increasing  from  35  knots,  at  0000  14  August 
1985,  to  60  knots  at  1800  14  August  1985.  During  this  period,  its  forward 
speed  remained  fairly  steady  within  the  range  of  11.5  to  12.4  knots,  while  its 
central  pressure  dropped  from  1010  to  1001  mb. 

84.  At  0000  15  August  1985,  having  wind  speeds  of  70  knots,  Danny  was 
classified  as  a  category  1  hurricane  on  the  Saff ir-Simpson  scale.  Central 
pressure  steadily  dropped  from  997  to  987  mb  at  the  time  of  landfall,  and  wind 
speeds  increased  to  80  knots.  For  the  next  20  hr,  the  hurricane  steadily  lost 
intensity  as  it  moved  inland,  with  maximum  wind  speeds  diminishing  to 

30  knots,  and  the  central  pressure  increased  to  1,000  mb.  A  summary  of  hurri¬ 
cane  parameters  is  presented  in  Table  3-7. 

85.  This  test  problem’s  input  data  set  is  presented  in  Table  3-8. 

Three  time-series  graphs,  showing  wind  magnitude  and  direction,  and  atmospher¬ 
ic  pressure  deficits  are  presented  in  Figures  3-27  through  3-29.  Vector  wind- 
field  graphs  are  presented  in  Figures  3-30  through  3-32.  The  simulation’s 
input  data  summary  is  presented  in  Table  3-9. 


Figure  3-26.  Approximate  path  of  Hurricane 
Danny,  August  1985 


Table  3-7 

Preliminary  Best  Track  Data  for  Hurricane  Dannv 


Time 

CPI 

Wind 

Date 

GMT 

Lat 

Lone 

mb 

knots 

8/14 

0000 

23.7 

87.8 

1010 

35 

8/14 

0600 

24.4 

88.8 

1007 

45 

8/14 

1200 

25.1 

89.8 

1004 

50 

8/14 

1800 

25.9 

90.7 

1001 

60 

8/15 

0000 

26.8 

91.5 

997 

70 

8/15 

0600 

27.8 

92.2 

995 

75 

8/15 

1200 

28.9 

92.6 

988 

80 

8/15 

1630 

29.6 

92.7 

987 

80 

8/15 

1800 

30.0 

92.7 

988 

70 

8/16 

0000 

31.0 

92.4 

992 

50 

8/16 

0600 

32.0 

92.0 

997 

40 

8/16 

1200 

32.9 

91.4 

1000 

30 

8/16 

1800 

33.7 

90.4 

1002 

30 
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GENSPECS 

Test  No. 

2:  Hlndcast  Storm 

ENGLISH 

TIMESPEC 

900.0 

MINUTES 

0. 

0  3600.0  15.0 

GRIDSPEC 

RECTANG 

ENGLISH  26  24  38216.3 

38216.3 

28.48  92.10 

340.0 

PRWINDOW 

RECGAGE 

5 

17 

SUBMERGED  PIPE  LOCATION 

RECGAGE 

10 

17 

DUMP  SITE  LOCATION 

RECGAGE 

15 

17 

MARSH  ISLAND  LOCATION 

RECSNAPS 

TIMES 

600. 

1200  2400  3600 

WINDSPEC 

SPHVARIABLE 

KNOTSMILLIBAR  5.0 

SPHSPEC  1014.000 

40.0 

i  60. 

0  168.0  11.7 

TABSPH 

00. 

00. 

23.700 

87.800  1010.00 

60.0 

35.0 

127.32 

31.0 

TABS PH 

06. 

00. 

24.400 

88.800  1007.00 

60.0 

45.0 

127.47 

31.0 

TABSPH 

12. 

00. 

25.100 

89.800  1004.00 

60.0 

50.0 

134.4 

31.0 

TABSPH 

18. 

00. 

25.900 

90.700  1001.00 

60.0 

60.0 

141.31 

31.0 

TABSPH 

24. 

00. 

26.800 

91.500  997.00 

50.0 

70.0 

147.98 

31.0 

TABSPH 

30. 

00. 

27.8 

92.2  995.00 

45.0 

75.0 

162.17 

31.0 

TABSPH 

36. 

00. 

28.9 

92.6  988.00 

40.0 

80.0 

172.86 

30.0 

TABSPH 

40. 

30. 

29.6 

92.7  987.00 

40.0 

80.0 

180.0 

29.0 

TABSPH 

42. 

00. 

30.0 

92.7  988.00 

40.0 

70.0 

194.56 

29.0 

TABSPH 

48. 

00. 

31.000 

92.400  992.00 

37.0 

50.0 

198.92 

29.0 

TABSPH 

54. 

00. 

32.000 

92.000  997.00 

3/  .0 

40.0 

209.48 

29.0 

TABSPH 

60. 

00. 

32.900 

91.400  1000.00 

37.0 

30.0 

209.48 

29.0 

— 

BATHS PEC 

YX 

(8X.9F8.1) 

1 
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-13.0 

-13.0  -13.0 
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w 
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SITE  LOCATION 
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Figure  3-28.  Test  2  hydrograph  for  gage 
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Test  No.  2s  HLndcost  Storm 


MIND  VECTORS 


SIMULATION  TIME*  20.00 HOURS 
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Figure  3-30.  Test  2  wind-field  snapshot  at  hour  20 


Test  No.  2i  HLndcost  Storm 


MIND  VECTORS  SIMULATION  TIME*  40. 00 HOURS 


Figure  3-31.  Test  2  wind-field  snapshot  at  hour  40 


Test  No.  2:  Hlndcost  Storm 


HIND  VECTORS  SIHUIRTION  TIME*  60.00H0URS 


WIND  REFERENCE  LENGTH:  60.00  KNOTS 


Figure  3-32.  Test  2  wind- field  snapshot  at  hour  60 
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Table  3-9 

Input  Data  Summary  for  Test  2 


Test  No.  2:  Hindcest  Store 


«•••  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  SENEftAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALLE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

• 

•••••  6RIDSPEC  CARD:  SPECIFICATION  OF  TT€  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VAU£: 

6RTYPE 

TYPE  OF  FINITE-DIFFERENCE  «10 

RECTANG 

•  SUNITS 

SYSTEM  OF  WITS  USED  FOR  THE  GRID 

ENGLISH 

HULL 

WIDER  OF  GRID  CELLS,  X  DIRECTION 

26 

»  YCELL 

WIDER  OF  GRID  CELLS.  Y  DIRECTION 

24 

DX 

SPATIAL  STEPSIZE  IN  X  DIRECTION 

38216.30 

•  DY 

SPATIAL  STEPSIZE  IN  Y  OIAECTION 

3B216.30 

GLATT 

LATITUDE  OF  GRID  ORIGIN  (DEGREES! 

28.48 

•  GLOW 

LONG  HIDE  OF  GRID  0RI6IN  (DEGREES) 

92.10 

GALIGN 

GRID  ROTATION  FOR  EAST  (OEGREES) 

340.00 

• 

TIItSPEC  CARD:  SPECIFICATION  OF  COtfUTATIONAL  TIIC  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

•  VARIABLE 

DESCRIPTIEM  OF  USAGE: 

VALUE: 

BELT 

COMPUTATIONAL  TINE  STEP  (TUNITS) 

900.0 

»  TWITS 

Tilt  WITS  FOR  ML  IIPIIT  VARIABLES 

MIWI7IS 

TPROV 

THE  AT  START  OF  MODEL  SIMULATION 

0.0 

•  THAI 

TOTAL  Tilt  OF  SIMULATION 

3600.0 

DTGABS 

TIIE  INTERVAL  TO  SAVE  GAGE  DATA 

15-00 

•  DTHOTS 

Tilt  INTERVAL  TD  SAVt  HOTSTARTS 

3600.00 

1  08/14/9111  COASTAL  NODELIN 

G  SYST 

EM  (CMS): 

SPH,  VERSION  1.0  :: 

Z0:36 

•MM  HYDROGRAPH  AM)  VELOCITY  IOSUREMENTS: 

3  GAGES 

GAGE  BASE-POSITION  VELOCITYHEASURQCXT 


wider: 

X 

y  notes: 

type:  NOTES: 

GAGE  NAIt: 

l 

5 

17 

UAVGVAVG 

SUatRSED  PIPE  LOCATION 

2 

10 

17 

UAVGVAVG 

OIF  SITE  LOCATION 

3 

15 

17 

UAVGVAVG 

HARSH  I SLAW  LOCATION 

•••••  THtS  FOR  SNAPSHOTS  OF  DATA  SAVED  (MINUTES  >: 


600.000 

1200.000  2400. OOC 

1  3600.000 

•MM  PRINTINS 

OF  FIELD  ARRAY  VARIABLES:  1  AREAS 

AREA  « 

STARTING  ENDING 

STARTING  ENDING 

•  TlltS  TO  PRINT 

(MINUTES  >: 

* 

VARIABLE  FIELD 

WIDER  • 

X  CELL  X  CELL 

Y  CELL  Y  CELL  WITES: 

•  START  AT 

END  AT 

INTERVAL  NOTES: 

• 

ARRAYS  TO  PRINT: 

1  • 

1=  I  X=  26 

Y*  1  Y=  24 

•  0.0 

3600.0 

1.0 

• 

W> 

1  OS/14/9111 

COASTAL  H0DELIN6  SYSTEM 

(CMS): 

SPH, 

VERSION 

1  . 

0  -.20-.36 

«••»  NINDSPEC  CARD:  SPECIFICATION  OF  TIC  NIND  FIELD  - 


I 


NOTES: 


IOTES: 


NOTES: 


NOTES: 
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APPENDIX  3-A:  SPH  DATA  SPECIFICATION  RECORDS 
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(Req)  GENS PECS 

(Req)  TIMESPEC 


Specify  general  title  and  system  of  units 
Specify  time -related  controlling  variables 


(Req) 

(C-Opt) 

(C-Opt) 


(Req) 

(Req) 

(Opt) 


(Opt) 

(C-Opt) 

(Req) 

(Req) 


(Req) 

(Opt) 

(Opt) 


GRIDSPEC 

XSTRETCH 

YSTRETCH 


BATHSPEC 

CHNGBATH 


WINDSPEC 
TABWINDS 
SPHSPEC 
TABS PH 


PRWINDOW 

RECGAGE 

RECSNAPS 


Grid  Description 

Specify  general  grid  characteristics 
Specify  x-coordinates  to  create  stretched  grid 
Specify  y-coordinates  to  create  stretched  grid 

Physical  Characteristics 

Specify  characteristics  of  bathymetry/topography 
Two-dimensional  array  of  bathymetric/topographic  data 
Specify  changes  to  the  bathymetric/topographic  data 

Wind-Field  Specifications 

Specify  the  character  of  wind- field  data 
Specify  wind- field  tabular  data 
Specify  general  data  for  SPH  wind  model 
Specify  SPH  paramenters  at  a  given  time 

Output  Specifications 

Specify  location  and  timing  of  a  print  window 
Specify  location  of  recording  gage  in  grid 
Specify  snapshot  time(s)  for  recording 


CMS  Data  Specification:  GENSPECS  Record:  (Req) 

Purpose:  Specify  general  title  and  system  of  units. 


Vl  Vl 

0  o 

t*  <4-1 

44 

•H  0 

J-l  l-l 

C  4J 

■§ 


«s  <S 


CO 

u 

M 

On  *. 

on  < 


0  vl 
0  0 
Vi  VI 
0  3 

H  ft  VI 

OH  *H 

0  o  c 

Q  O  D 


Vi 
0 
VI 
U  0 
0  > 
0 

O  \  <VI 

0  H  o 
o  w  _ 
0S3  , 

0  a  u  h 


O  0 
«  * 
0 

o  \  <vi 
0  vi  o 

0  44  ^ 

o  s 

vi  0  vi  3  vi 

4-10  4-10  4-1 


M<0 
VI  VI  n 

•e  14  0  3 

vi  o  -C:  0 

60  0  O  O  0 

C  a  rH  0  0 

0  in  0  t4  Vi 

J  H  >  O  On 


VI 

0  O’ 
VI  0 

CO  06 


0  oo  M3 

p\  *  * 


•0  ^ 

6  6  5 


I  § 


3-63 


CMS  Data  Specification:  TIMESPEC  Record:  (Req) 

Purpose:  Specify  time-related  controlling  variables. 


w 

o 

•H 

4J 

CO 

*H 

CD 

4-> 

O 

cd 

& 

■g 


VI 

bO 


s 

O 


/-s  V) 

cr  3 
<u  ev 

p4  a 
— '  o 
o 


•a 

Vi 

O 


u  0) 


c 

y 

bO 


<U 

ed 
o 

w  tn 

CM  4m 
CO  iM 

a  o 
i-i  at 
a  a. 
o  oo 


3 


Vi 

.  « 
«J  vM 

bi  <4-1 


•a 

VI 

o 

o 

« 

Pi 


a 

w 

Pm 

co 

a 

M 

Pi 

o 


•  •9 

•o 

y 

■d 

r-l  VI 

*4M  Vl 

0) 

rM  O 

* 

• 

O  3  rM 

o 

y  o 

c 

c 

M  18 

cd 

y  y 

o 

0 

y  «8  B 

a* 

Vi 

■H 

iM 

rM 

rM  y  iM 

(0 

bO  n 

x 

VI 

rH 

bO  b  y 

i 

C  i-i  X 

y 

y 

c 

c  S 

1 

S  i! 

u 

•w  m  y 

• 

y 

y 

o 

O  B 

•— i 

IS  r—  n 

p 

X  bOH 

<4 

Vi 

M 

iM 

iM  iM 

y 

CO  1-r 

cd 

U  W 

VI 

•H 

iM 

X 

vi  y 

y 

2  a 

4J 

41  II  S 

y 

•a 

•© 

y 

y  y 

n 

o  y  4i 

CO 

1)  i)  H 

■o 

i 

* 

y 

V  03 

X  CO 

P 

Vi  cd  CO 

x 

>< 

M 

Vl  w 

•O  co  « 

o 

x  y  >h 

iM 

•H 

P 

y  x  y 

o 

co  Vi 

•H 

c 

c 

n 

•o  c 

iM 

iM  « 

o  *d 

VI 

i-4 

•rl 

i 

i  iM 

hO 

4m  a 

& 

X  c 

bO 

X 

Jm  bO 

iM 

iM  c  O 

ti 

X  O  cd 

co 

M 

iM 

u 

y  y  Vi 

•H 

•W  VI  r-v 

Vi 

r— 1 

X 

p 

c  vi 

o 

«  hM  4M 

S  XU 

O 

i—4 

rM 

IM 

iM  O 

P.  40 

now 

4M 

V 

y 

n 

CO  y  y 

s 

0  0)  H  Pm 

y 

y 

y 

y  n 

iM 

X  CO 

a> 

II  >>Id  CO 

(A 

N 

N  «M 

Vl 

••KM 

4-> 

x  o  sd  a 

VI 

n 

n 

iM 

iM  Vl 

bO 

td  <8  » 

co 

»  H  H  H 

iH 

iM 

iM 

M 

10  bO 

COX 

>*> 

>-,  CM  CO  OS 

c 

U 

Vl 

P.  • 

cm  • 

4M 

y  y 

co 

• 

»  B  X  O 

3 

bO 

bO 

y  r-s 

y  r-v  4m 

O 

i  i)  ° 

co 

a> 

X  co 

x  CO  0 

C  O  rM 

p 

»H 

C  «  V 

4M 

4M 

4m 

W  H 

co  H 

• 

y  • 

b0  4M  y 

• 

cd 

H 

<8  PS  81  X 

© 

O 

O 

M 

m  y 

y— » 

n  — v 

•H  v  1 

x-' 

•H 

0) 

i-l  O  Vi  VI 

rH  2 

rM  x  n 

CO 

3  w 

rH 

CO 

(0 

O 

CO  iH  i-i 

a 

u 

Vl 

cd  p 

18  P  3 

y 

vi  y 

<d  w  a) 

a> 

<u 

y  vi  3  Vi 

y 

y 

y 

«H  O 

MU  VI 

y 

—I  y 

•H  4J 

a; 

4-> 

vi  y  cr  y 

VI 

X 

X 

VI  iM 

Vl 

00  Vi 

•O  X  c 

>-» 

•H 

Vi  C  y  VI 

10 

i 

§ 

cd  P 

co  C  x 

b0 

C  bO 

•rM  (8  3 

w 

«d 

>-l 

(8  3  VI  4m 

X 

3 

3 

Pd*H 

ti  iM  <8 

y 

o  y 

X  •  O 

0) 

a 

bO  U  4h  — '  (8 

CO 

X 

X 

C/5 

co  - —  X 

n 

x  n 

u  x  y 

V) 

r-M 

3 

cfl 

4-1 

a) 

a 


cr 

y 

as 


o 


H 

O 

9 


u 

§ 

e 

w 

Pd 


VI 

a 

o 


X 

u 

H 


H 

co 

dS 


X 

CO  o 

l-l  M 

X  Pi 

a  h 


* 

M 

+ 


l 


5 


* 

pd 


ti 


* 

pi 


X 

CO 

3 

o 


£ 


a* 

u* 

cr 

o* 

cr 

cr 

cr 

a) 

4) 

y 

0) 

y 

y 

a> 

Od 

cd 

Qd 

X 

OS 

04 

00 

00 

00 

X 

M 

0) 

•)c 

Ml 

* 

y 

y 

p 

bO 

b0 

,,  . . 

> 

X 

n 

y 

V 

C  <U 

H 

cd 

<8 

cd 

X 

X 

O  (A 

X 

c 

c 

•H  O 

CJ 

o 

o 

VM 

VM 

iJ  do 

cd  u 

o  P 

■H  04 

0) 

rH 

«H 

rO 

a 

w 

C/5 

CO 

Vi 

O 

cd 

»H 

Pm 

H 

X 

X 

V 

*H 

A 

>i 

M 

X 

X 

Dm 

H 

2 

td 

(d 

C/5 

cd 

Pi 

P 

o 

u 

J> 

a 

O 

O 

X 

>M 

<d 

4J 

cd 

Q 

'OJ 

H 

co 

a> 

rH 

CM 

fO 

-8 

m 

X 

•H 

o 

pt4l 

<d 

*2 


4 

Q> 

a$ 


a 


vO 


s 


cd 

0) 

od 


H 

3 

u 


00 


«d 

0) 

Pi 


O 

X 


o 


<8 

a» 

as 


X 

o 

l-l 

X 

Si 


3-65 


Vl 

to 

4) 

c 


VI 

O 

4) 

Vl 

*3 

4) 

•s 

Vi 

4) 

W 

Vi 

10 

<0 

C 


(0 

4) 

Vl 

4) 

c 

/\  1-4 
VI  -O 

a  vi 
o  o 
•  o 
o  o 


•3 

Vi 


Vi 

40 


O  4)  41 

O  VI  Vi 

44 

4)  <0  tfl 

*-l 

OS  0)  X 

2 

Vi  tfl 

CtJ 

X  o 

44 

U  41 

4) 

H  O  VI 

oi 

<4 

C 


M 
a; 

H  <0  ■ 

«  ut) 

>1  <0  Vi 

•o  o 


•o 

G  4) 
<0  X 


X 

O  .  . 

H  ‘vi  (0 


"  s 

X 


w 

OS 

H 

l/i 


4) 
O  Vi 
4)  U 

O.  a) 


X  oo  O 


4) 

10 

o 

a 

Vi 

3 

a< 


u 

4) 

CV 

v> 


vi 

«d 

Q 

vi 

5 


4) 

bl 

a) 

w 


49  to 

4)  « 

V>  VI 

3  3 

i-4  i-l 

•3  •O 

6 

o 

i-4 

40 

41 

Vl 

o 

to  3 
4) 

VI  40 

2  5 

Vi  Vi 

O  O 

o  o 

•§ 

Cft 

§ 

•r4 

VI 

•3 

G 

X 
•3  O 

o  o 

1  1 

•o 

to 

a> 

41 

10 

Vi  I-l 
O  0. 

X  X 

•H 

V4 

3 

o  B 

r\  At 

Vi  H 
O  O 
44  4-1 


VI 

4) 


•0 
4) 
vi  a) 
vi  vi 

g| 

4) 

Pm 


44 

i-l 

VI 

c 

41 

•3 


■3 

Vi 

O 

O 

41 

Ptf 


X  X 
O  O 
H  H 
Ci]  U 

oi  oi 
H  H 
V)  CO 

x  ;« 


■s 

iM 

M 

<S 


■3 

i — I 

4> 

•—I 


40 

44 

O 

C 

i-l 

g 

»t-l 

40 

4) 

J3 

VI 

a 

CO 

4= 

a. 


& 

44 

O 

41 

VI 

tfl 


M 

0. 


10  I 

4)  *3 
•H  C 
O  <0 
1-1 

44  i 
44  X 
41 

O  4> 
40 

C  4) 


O 

G  44 
O 
i-l  4) 

40  X  * 

41  VI 

VI  « 
jO  44 
3  0  + 
to 

c  < 

"3  O 
1-1  1-1  I 
Vi  VI 
40  C  X 


*  * 

1-4  M 


* 

as 


ccS 


pel 


/N 

cr 

cr 

/-V 

a* 

/-s 

cr 

a* 

cr 

a> 

a) 

<D 

0) 

a> 

a) 

aj 

s/ 

oi 

Oi 

V-' 

erf 

>*✓ 

Crf 

'■w' 

QO 

Vl 

n 

* 

0) 

41 

CO 

40 

vi 

a> 

41 

as 

Vi 

c 

C 

u 

HH 

1-4 

41 

Oi 


Oi 


CO 

41 

PtS 


w 

al 

a 


PO 


IO 


CJ 


00 


o 

Vi 

41 


CM 

G 

O 

i4 

cr 

oS 


X 

w 

<V4  /-» 

c 

O  6 

*r4 

Vl 

o 

44  5 

X 

Vl  o 

*r4  •  1 

a)  as 

Vl  44 

44 

4)  i/ 

» 

40  41 
4>  40 

44  a> 

c 

o  X 

as  3 

CO  T3 

•«-4 

a 

•  JO 

•  o 
v  cd 
•H  0. 

*w 

E 


<0 

41 

0 

O 

X 


f4  n  n  •} 


3-66 


CMS  Data  Specification:  BATHSPEC  Record:  (Req) 
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(1)  The  actual  2-D  array  of  bathymetry/topography  data  follows  this  reo 

(2)  Conventions  for  2-D  array  read  sequence  mnemonics: 
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CMS  Data  Specification:  CHNGBATH  Record:  (Opt) 

Purpose:  Specify  changes  to  the  bathymetry  data. 
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CMS  Data  Specif ication:  WINDSPEC  Record:  (Req) 

Purpose:  Specify  the  character  of  wind- field  data. 
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WFETHR  Real  (Opt)  0.  +R*  The  wind  field  is  gradually  spline  fit 

from  quiescent  conditions  to  the  given 
(or  interpolated)  value  over  the  WFETHR 
period  (in  TUNITS) . 


CMS  Data  Specification:  SPHSPEC  Record:  (Req) 

Purpose:  Specify  general  data  to  be  employed  by  an  SPH  wind-field  model. 
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CMS  Data  Specification:  PRWINDOW  Record:  (Opt) 

Purpose:  Specify  location  and  timing  of  a  print  window. 
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Depth  of  water 
Friction  value. 


E  and  V  at  previous  time-step  (three 


CMS  Data  Specification:  RECGAGE  Record:  (Opt) 
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CHAPTER  4 


WES-imiCIT  FLflQDINC  MODEL  (WIEM) 

THEORY  AND  PROGRAM  DOCUMENTATION 

PART  I :  INTRODUCTION 

1.  Use  of  time -dependent  numerical  models  for  simulating  long-period 
wave  behavior  in  open  coastal  waters,  estuaries,  bays,  and  lakes  has  increased 
rapidly  in  recent  years.  Two-  and  three-dimensional  numerical  solutions  of 
the  governing  partial  differential  equations  are  employed  in  most  shallow- 
water  long-wave  applications.  This  chapter  documents  the  WES  Implicit 
Flooding  Model  (WIFM) ,  a  two-dimensional,  depth- integrated  model  for  computing 
tidal  circulation  and  storm  surge  propagation.  The  model  was  originally 
developed  at  WES  (Butler  1978a)  and  has  evolved  as  it  has  been  applied  to 
problems  involving  simulation  of  long-period  wave  behavior  (Butler  1978b). 
Successful  applications  of  the  model  include  simulations  of  tidal  circulation 
(Butler  1978a,  Butler  1983),  storm  surge  (Butler  1984,  Hardy  and  Crawford 
1986),  and  tsunami  inundation  (Houston  and  Garcia  1974). 

2.  WIFM  is  a  two-dimensional  model;  therefore,  velocities  are  treated 
as  depth- integrated  quantities  (i.e.,  velocities  are  constant  in  magnitude  and 
direction  over  depth) .  The  model  solves  finite  difference  approximations  of 
the  Navier-Stokes  (continuity  and  horizontal  momentum)  equations  for  the  water 
surface  displacement  (*j)  and  the  vertically  integrated  velocities  (u  and  v) . 
The  basic  implicit  solution  schemes  used  in  WIFM  were  developed  by  Leendertse 
(1967,  1970,  1971)  and  Weare  (1980).  The  treatment  of  flooding/drying  is 
original  in  WIFM,  whereas  the  handling  of  subgrid  barriers  follows  the 
procedures  presented  in  Reid  and  Bodine  (1968).  WIFM  can  simulate  flow  fields 
induced  by  wind,  river  inf lows /outf lows ,  and  tidal  forcing. 

3.  A  thorough  understanding  of  the  model's  capabilities  and  limitations 
prior  to  any  attempt  to  apply  it,  is  essential.  WIFM  is  not  a  "total  solu¬ 
tion"  to  a  hydrodynamic  problem.  The  user  must  ensure  that  limitations 
imposed  by  shallow-water  wave  theory  (i.e.,  water  depth  is  sufficiently  small 
when  compared  with  wavelength)  are  applicable  to  the  problem  being  investi¬ 
gated.  Furthermore,  the  model  should  not  be  treated  as  a  "black  box";  the 
engineer  or  scientist  must  check  model  results  to  see  if  these  results  are 
reasonable . 
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4.  This  chapter  is  divided  into  five  sections:  Part  II  presents  the 

governing  equations  and  computational  scheme  used  in  the  model,  Part  III 
defines  the  input  data  formats,  Part  IV  discusses  the  model's  input  data 
requirements,  and  Part  V  contains  two  illustrative  examples. 
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PART  II:  SHALLOV - WATER  WAVE  EQUATIONS 

Assumptions  and  Limitations 

5.  Proper  application  of  any  model  requires  a  clear  understanding  of 
the  physical  processes  occurring  in  a  study  area  and  a  comprehension  of  the 
capabilities  of  a  given  model  to  simulate  those  processes.  Model  results 
should  provide  a  realistic  representation  of  the  physical  system  being 
modeled. 

6.  The  limitations  of  a  model  define  its  range  of  applicability.  In 
particular,  WIFM  is  a  two-dimensional  depth- integrated  model;  therefore,  the 
model  should  be  applied  only  where  the  water  column  is  well  mixed  and  no 
significant  vertical  variations  occur.  The  model  should  not  be  applied  if 
temperature  and/or  salinity  gradients  have  an  appreciable  effect  on  fluid 
motion  as  compared  with  external  forces.  In  addition,  hydrostatic  pressure 
conditions  are  assumed  in  the  model  formulation.  Thus,  the  model  should  be 
applied  only  where  there  is  no  significant  vertical  acceleration  of  the  water 
such  as  what  might  occur  near  an  outlet  structure.  Applying  WIFM  requires  a 
clear  understanding  of  the  model's  capabilities .  as  well  as  its  limitations. 
WIFM  can  simulate  flow  fields  induced  by  wind  fields,  river  inflows/outflows, 
and  tidal  forcing.  The  model  is  capable  of  flooding  and  drying  grid  cells  and 
simulates  submerged,  exposed,  or  overtopping  barriers. 

.  The  model  should  be  applied  such  that  time  and  length  scales  associ¬ 
ated  with  long-wave  processes  can  be  resolved.  The  minimum  wavelength  that 
can  be  resolved  by  the  model  is  equal  to  twice  the  width  of  the  smallest  grid 
cell;  however,  wavelengths  used  in  long-wave  models  are  much  greater  than  the 
minimum  resolvable  wavelength.  Since  shallow-water  wave  theory  is  only  valid 
where  the  water  depth  is  small  in  relation  to  the  wavelength  (d/L  <  0.04),  the 
minimum  wavelength  must  be  greater  than  or  equal  to  25  times  the  deepest 
water  depth.  These  constraints  indicate  the  importance  of  careful  selection 
of  the  length  scale . 

8.  The  length  scale/time  scale  ratio  must  be  of  the  same  order  of 
magnitude  as  the  shallow-water  wave  celerity  in  order  to  reproduce  wave 
propagation  accurately.  The  model  must  be  able  to  resolve  a  fluid  particle 
moving  from  one  cell  to  the  next.  Since  the  travel  time  of  that  particle  is 
dependent  on  the  cell  width  as  well  as  the  wave  celerity,  the  time  interval 
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between  successive  numerical  solutions  of  the  governing  equations  must  be 
chosen  carefully.  The  Courant  number,  Ct  ,  defines  the  relationship  of  wave 
celerity  and  grid  speed: 


(4-1) 


where 

g  -  gravitational  acceleration 

h  -  water  depth 

Ax  -  grid  cell  width  in  the  direction  of  wave  propagation 

At  -  time  interval  between  successive  calculations 

For  the  Alternatir  Direction  Implicit  (ADI)  scheme  used  in  WIFM,  the  Courant 
number  should  usually  be  less  than  a  value  of  5.  Larger  values  of  the  Courant 
number  may  be  permissible  at  a  distance  from  the  area  of  interest  within  the 
computational  domain;  however,  numerical  accuracy  will  be  affected. 

9.  A  thorough  comprehension  of  the  physical  processes  simulated  by  the 
model  is  necessary  to  ensure  that  the  model  is  applied  to  appropriate  prob¬ 
lems,  that  it  is  applied  correctly,  and  that  accurate  results  are  produced.  A 
discussion  of  the  hydrodynamic  equations  used  in  WIFM  is  provided  in  the 
following  section.  It  is  recommended  that  the  reader  refer  to  Horikawa  (1988) 
for  a  detailed  discussion  of  coastal  hydrodynamics. 


10.  The  hydrodynamic  equations  used  in  WIFM  are  derived  from  the 
classical  Navier-Stokes  equations  formulated  in  a  Cartesian  coordinate  system 
(Figure  4-1).  If  the  vertical  water  accelerations  are  assumed  to  be  small 
compared  with  the  gravitational  acceleration  (hydrostatic  pressure  conditions 
exist)  and  the  fluid  is  homogeneous  and  incompressible,  the  depth -averaged 
approximation  is  appropriate  and  yields  the  following  two-dimensional  form  of 
the  governing  equations: 
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Figure  4-1.  Cartesian  coordinate  system 


du  .  .  „du  .  _  d  _  » 

Ti  u~Sc  v-&  ^(T»  T,*) 


-  fv  -  l!±  +  +  A  { 

P  d  pd  *\ 


8au  ^  82u 

cbc2  dy2 , 


(4-2) 


ft  *  “£  *  * fu  -  ^3  *  *  0)  ■ 0  <4_3) 


(4-4) 


I  II  III  IV  V  VI 

where 

x,  y,  t  -  independent  space  and  time  variables 

r)  -  water  surface  displacement  measured  relative  to  an  arbitrary 
datum 


rjt  -  water  surface  displacement  due  to  the  atmospheric  pressure 
anomaly 

h  -  static  water  depth  measured  from  the  same  datum 
d  -  total  water  depth  (h  +  fj) 

u,  v  -  velocity  components  in  the  x-  and  y-directions ,  respectively 
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rBx  •  rBy  “  bottom  friction  stresses  in  the  x-and  y-directions , 
respectively 

f  -  Coriolis  parameter 

Ah  -  generalized  diffusion  coefficient 

g  -  gravitational  acceleration 

rax>  T»y  ~  external  surface  shear  stresses,  such  as  wind  stress, 

in  the  x-and  y-directions,  respectively 

p  -  water  density 

R  -  source/sink  term  to  account  for  mass  changes  such  as  rainfall, 
percolation,  etc. 

Equations  4-2,  4-3  and  4-4  represent  the  nonconservative  form  of  the  x- 
momentum,  y-momentum,  and  continuity  equations,  respectively.  The  model  is 
capable  of  using  the  conservative  form  of  Equations  4-2  through  4-4  as  well. 

11.  A  detailed  discussion  of  the  Navier-Stokes  equations  with  a 
rigorous  derivative  of  each  term  is  found  in  Harris  and  Bodine  (1977).  A 
brief  discussion  of  the  physical  significance  of  the  six  groups  of  terms  in 
Equations  4-2  through  4-4  is  given  below  and  in  Table  4-1.  The  Roman  numerals 
below  correspond  to  the  Roman  numerals  in  Equations  4-2  through  4-4: 

I.  Local  flow  acceleration  (i.e.,  local  variation  of  momentum  with 
respect  to  time) . 

II.  Transport  of  momentum  by  advection  (i.e.,  spatial  acceleration). 

III.  Barotropic  pressure  forces  and  conservation  of  mass. 

IV.  Momentum  sources  and  sinks  due  to  Coriolis  force  and  surface  wind 
stress . 

V.  Momentum  sink  due  to  bed  friction. 

VI.  Horizontal  diffusion  of  momentum. 
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Table  4-1 


Description  of  Terms  in  the  Governing  Equations 


du  dv 
at'  ~5t 


Definition  and  Discussion _ 

Change  of  the  vertically  averaged  velocity  with  respect 
to  time.  Change  may  result  from  temporal  acceleration 
of  the  mean  flow. 


d_ 

dx 


<11 -na) 


Pressure  gradient  terms;  describes  the  slope  of  the 
water  surface;  principal  driving  force  of  fluid  flow. 


Bottom  friction  terms;  stress  of  the  fluid  layer 
against  the  bottom  boundary;  serves  as  an  energy  dissi- 
pator. 


Coriolis  terms;  accounts  for  the  effect  of  the  Earth's 
rotation. 


Inertia  (advective)  terms;  describes  the  movement  of 
water  due  to  the  fluid  motion  itself. 


External  shear  stresses  (such  as  the  wind);  any  forcing 
function  that  serves  to  drive  the  fluid  motion. 


)  Horizontal  diffusion  of  momentum;  describes  the  dis¬ 
persion  of  momentum  due  to  fluid  motion;  is  some¬ 

times  referred  to  as  the  eddy  viscosity. 


dt 


Change  in  water  level  with  respect  to  time. 


Rate  at  which  water  is  converging  or  diverging  horizon¬ 
tally  at  a  given  point  (x,y)  in  space. 


Sink/Source  term  that  accounts  for  mass  changes  (i.e. 
rainfall,  percolation). 


12.  Various  formulations  of  the  terms  in  the  governing  equations  are 
permissible.  The  expressions  for  bottom  friction,  diffusion,  wind  stress,  and 
the  Coriolis  coefficient  employed  in  WIFM  are  as  follows: 

Bottom  friction 

13.  The  bottom  shear  stress  impeding  fluid  motion  in  unidirectional 
open  channel  flow  can  be  expressed  in  terms  of  a  quadratic  (nonlinear) 
friction  law: 


(4-5) 


where 

p  -  fluid  density 

f  -  Darcy-Weisbach  friction  factor 

u  -  fluid  velocity 

The  importance  of  the  direction  of  the  velocity  in  oscillatory  flow  means  that 

Equation  4-5  must  contain  an  absolute  value  sign: 


(4-6) 


14.  WIFM  uses  the  following  quadratic  expressions  to  represent  the 
bottom  shear  stress  in  the  x-momentum  equation: 

Is*  =  _2H.  (u2  +  v3)*  (4-7) 

P  dd 

where 

p  -  fluid  density 

g  -  gravitational  acceleration 

Cjj  -  Chezy's  friction  coefficient 

d  -  water  depth 

u,  v  -  velocity  components  in  the  x-and  y- directions ,  respectively. 

A  similar  expression  is  used  for  tBy  in  the  y-momentum  equation. 

15.  Rather  than  specifying  the  Chezy  coefficient,  Manning's  n  ,  which 
is  a  function  of  depth,  is  often  prescribed  (Chow  1959).  The  two  coefficients 
are  related  through  the  following  equation: 
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(4-8) 


Cm 


<p/« 

n 


WIFM  uses  a  spatially  variable  drag  coefficient,  n  .  The  advantage  of  a 
variable  drag  coefficient  is  that  variation  in  depth  can  be  factored  into 
bottom  shear  stress  computations . 

Diffusion  coefficient 

16.  The  diffusion  (or  eddy  viscosity)  coefficient,  Ag  ,  can  be  treated 
as  variable  or  constant  in  WIFM  and  describes  the  rate  of  diffusion  of 
momentum  due  to  the  fluid  motion.  Variable  Ag  is  formulated  by  Vreugdenhil 
(1973)  as 

A  -  6<J[g(ua  *  va)1/2]  (4-9) 

H  Cz 

where 

d  -  total  water  depth 

g  -  gravitational  acceleration 

u,  v  -  vertically  integrated  velocity  components 

Cz  -  Chezy  coefficient 

Constant  Ag  usually  ranges  from  5  to  20  (English)  or  0.5  to  2.0  (metric). 
Wind  stress  coefficient 

17.  The  wind  stress,  ts  ,  is  formulated  as: 

t,  =  P,CD\W\W  (4-10) 


where  p#  is  the  air  density,  W  is  the  wind  velocity,  CD  is  the  wind  drag 
coefficient  determined  from  Garratt's  equation  (Garratt  1977): 

r  _  (0.75  +  0  ■  067o>)  (4-11) 

D  1000 


and  <a  is  the  resultant  wind  speed  (meters/second).  The  wind  velocity,  W  , 
and  the  wind  stress,  ts  ,  are  converted  by  the  model  and  need  not  be  given  in 
metric  units. 

Coriolis  coefficient 

18.  The  Coriolis  term  accounts  for  the  fact  that  the  Earth  is  rotating, 
whereas  the  coordinate  frame  of  our  computations  is  fixed.  The  Coriolis 
parameter,  f  ,  is  expressed  as: 
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f  *  2vsinA 


(4-12) 


where  v  is  the  angular  speed  of  the  Earth's  rotation  (7.292  x  10"5  rad/sec) 
and  X  is  the  latitude  of  the  study  area. 

19.  This  completes  the  basic  model  formulation.  If  further  details  of 
the  governing  equations  are  necessary,  the  reader  should  refer  to  Horikawa 
(1988). 


Grid  System 

20.  The  governing  equations  (Equations  4-2,  4-3,  and  4-4)  which 
describe  the  physical  processes  associated  with  shallow-water  wave  motion 
contain  partial  derivatives  with  respect  to  time  and  space.  WIFM  uses 
mathematical  (finite  difference)  approximations  to  represent  these  continuous 
equations.  The  continuum  is,  therefore,  represented  by  discrete  points  in 
time  and  space.  The  discretization  of  the  horizontal  plane  is  accomplished 
via  a  computational  grid  composed  of  a  lattice  network  of  cells.  Each  cell 
has  certain  flow  field  parameters  associated  with  it.  In  the  case  of  WIFM, 
the  water  surface  elevation  is  defined  at  the  center  of  each  cell,  and  the 
vertically  averaged  velocity  components  are  defined  at  the  cell  faces.  All 
information  required  as  input  to  the  model,  including  water  depths  and 
external  forces  (such  as  wind),  is  defined  at  each  grid  cell. 

21.  WIFM  is  capable  of  using  a  uniform  or  stretched  Cartesian  grid. 
Uniform  Cartesian  grids  simply  have  cells  of  equal  size  in  the  x-direction  and 
equal  size  in  the  y-direction  (Figure  4-2).  A  major  advantage  of  WIFM  is  the 
capability  of  applying  a  smoothly  varying  (stretched)  grid  to  a  given  study 
region  (Figure  4-3).  This  capability  permits  simulation  of  complex  geometry 
by  locally  increasing  grid  resolution.  This  feature  is  accomplished  by 
independently  applying  a  piecewise  reversible  transformation  for  each  direc¬ 
tion  (analogous  to  that  used  by  Wanstrath  et  al.  1976)  to  map  prototype  or 
real  space  (x,y)  into  computational  space  (0},a2). 

22.  The  transformation  in  each  piece  of  the  grid  takes  the  form  of: 
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x  -  a  ♦  bac 


(4-13) 


where  a  ,  b  ,  and  c  are  arbitrary  constants.  The  transformation  is  such 
that  cells  are  uniformly  spaced  in  computational  space;  therefore,  all  deriva¬ 
tives  are  centered  in  computational  space.  Many  stability  problems  commonly 
associated  with  variably  spaced  grid  schemes  are  eliminated  via  the  smoothness 
of  the  transformation  procedure.  The  transformed  equations  of  motion  are 
presented  in  the  following: 


Figure  4-2.  Uniform  Cartesian  grid 


Figure  4-3.  Stretched  Cartesian  grid 
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(4-14) 


X-momentum 


u,  +  —  uu.  *  —  vu.  +  -2.  («)  — 1|_>  _ 
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uv, 


'  +  —  w.  +  -2-  (it-nJ.  +  fu 
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pd 


(4-15) 


Continuity 


+  ji  {du),‘ *  i:  (dv)- =  R 


(4-16) 


where  lia  =  =  b1c1ac'~1  and  p3  =  =  i>3c3oc*' 


Computational  Technique 

23.  Since  analytical  solutions  of  the  governing  equations  have  been 
determined  only  for  very  simple  situations,  discrete  approximations  of  the 
governing  equations  are  required  to  produce  a  general  purpose  model  solution. 
This  is  accomplished  by  evaluating  the  derivatives  in  the  governing  equations 
with  finite  difference  approximations . 

24.  The  finite  difference  approximations  incorporated  in  WIFM  are  based 
on  an  Eulerian  system  where  the  velocities  and  water  surface  fluctuations  are 
computed  at  discrete  locations  within  the  flow  field.  A  network  of  grid  cells 
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is  used  to  define  the  spatial  distribution  of  these  paraaeter  locations.  A 
representative  grid  cell  is  shown  in  Figure  4-4.  The  water  surface 
fluctuations  are  solved  at  the  cell  center  (i.e.,  node  i,j).  X-direction 
velocities,  u  ,  are  found  at  the  "west"  and  "east"  cell  faces,  nodes  (i-l,j) 
and  (i,j)  respectively,  while  the  y-direction  velocities,  v  ,  are  computed  at 
the  "south"  and  "north"  faces,  nodes  (i,j-l)  and  (i,j),  respectively.  The 
finite  difference  equations  used  in  W1FM  are  as  follows: 


Figure  4-4.  Representative  grid  cell 


X- momentum 
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Y- momentum 
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Yz Continuity 
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- 
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- 

- 

spatially  averaged  quantity 

25.  The  computational  procedure  used  in  WIFM  to  solve  the  finite  dif¬ 
ference  equations  is  based  on  an  ADI  method.  The  advantage  of  this  method  is 
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that  it  allows  the  x- continuity  and  momentum  and  y-continuity  and  momentum 
approximations  to  be  solved  separately,  thus  permitting  the  flow  calculations 
to  be  made  in  two  stages  (Figure  4-5). 

26.  The  first  stage  consists  of  sequentially  solving  the  x-continuity 
and  x-momentum  equations  along  each  row  in  the  grid.  The  x-momentum  equations 
are  centered  about  the  cell  faces  and  are  solved  for  the  u-velocities .  The  x- 
continuity  equations  are  centered  about  the  cell  centers  and  are  solved  for 
the  surface  fluctuations.  The  u-velocities  and  surface  fluctuations  are 
solved  implicitly,  while  the  y-direction  velocities  are  supplied  from  time 
levels  k  and  k-1.  The  u-velocities  represent  those  at  time  level  k+l\ 
however,  the  surface  fluctuations,  ,  are  an  approximation  to  those  at  time 
level  k+1 . 

27.  The  second  stage  involves  sequentially  solving  the  y-continuity  and 
y-momentum  equations  along  each  column  in  the  grid  to  obtain  the  v-velocities 
and  water  surface  fluctuations  at  time  level  k+1 .  (/-velocities  are  provided 
from  time  levels  k-1  and  k. 

28.  Solving  the  finite  difference  approximations  by  a  fully  implicit 
scheme  requires  a  relatively  large  quantity  of  computer  resources.  A  more 
economical,  although  less  accurate,  calculation  method  is  to  use  a  tridiagonal 
matrix  solution  scheme.  WIFM  employs  a  three- time -level  "leapfrog"  scheme  to 
solve  the  tridiagonal  matrix  solution.  That  is,  at  time  level  k,  we  use 
information  from  time  level  k-1  and  leap  forward  in  time  to  a  solution  at  time 
level  k+1 . 


X-MOMENTUM 

Y-MOMENTUM 

X-CONTINUITY 

Y— CONTINUITY 

(First  Stags) 

(Second  Stage) 

Figure  4-5.  Computational  procedure  used  in  WIFM 
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29.  The  solution  matrix  for  each  row  and  column  results  in  N-2  simul¬ 
taneous  equations  containing  N  unknowns.  The  boundary  conditions  supply  the 
remaining  two  unknowns  needed  to  solve  the  matrix.  A  variety  of  boundary 
conditions  are  permissible  and  can  be  classified  into  chree  general  groups; 

(a)  open  boundaries,  (b)  land-water  boundaries,  and  (c)  subgrid  barrier 
boundaries . 

Open  boundaries 

30.  This  category  includes  seaward  boundaries  terminating  at  the  edge 
of  the  computational  grid  and  river  channels  entering/exiting  the  two- 
dimensional  grid  at  any  point  within  the  grid.  Water  levels  and/or  flow  rates 
at  the  boundary  points  are  prescribed  as  functions  of  location  and  time. 
Additional  open  boundary  conditions  (for  storm  surge  applications)  include 
specification  of  the  hydrostatic  elevation,  fja  ,  computed  by  the  Standard 
Project  Hurricane  (SPH)  model  and  a  uniform  flux  boundary  condition,  where 
boundary  values  are  estimated  from  parameters  within  the  grid.  Additional 
research  is  being  conducted  to  add  a  radiation  condition  option  at  open 
boundaries. 

Land-water  boundaries 

31.  WIFM  employs  a  deterministic  approach  for  simulating  flooding  and 
drying  of  low-lying  terrain.  As  water  levels  rise  during  a  tidal  cycle  or 
storm  surge,  grid  cells  that  were  once  dry  become  flooded  and  are  incorporated 
into  the  Navier-Stokes  computations. 

32.  Initially,  water  is  transferred  from  one  cell  to  an  adjacent  dry 
cell  based  on  discharges  computed  by  a  broad-crested  weir  formula: 

q  =  codi/2  (4-21) 


where 


33. 

puted  by: 


-  water  discharge  per  unit  width 

-  admittance  coefficient 

-  average  water  level  difference  between  the  cells 

The  incremental  water  level  increase  in  the  receiving  cell  is  com- 


(4-22) 


where 

T)r  -  incremental  water  level  increase 
At  -  time -step 

Axr  -  width  of  the  receiving  cell 

When  the  receiving  cell's  water  level  exceeds  a  small  prescribed  value,  it  is 
incorporated  into  the  Navier-Stokes  computations. 

34.  To  ensure  that  mass  is  conserved  in  the  system,  an  equal  volume  of 
water  added  to  the  receiving  cell  must  be  subtracted  from  the  donating  cell. 
Thus,  the  incremental  decrease  in  the  donating  cell's  water  level  is  calcu¬ 
lated  by: 


nd  - 


A  tq 
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35.  The  drying  algorithm  is  essentially  the  inverse  of  flooding.  If  a 
cell's  water  level  recedes  below  a  predetermined  level,  that  cell  is  removed 
from  the  Navier-Stokes  computations,  and  water  is  then  transferred  to  an 
adjoining  cell  with  rates  determined  by  the  broad-crested  weir  formula 
presented  above.  However,  this  formula  is  used  only  until  the  water  level 
recedes  below  a  second  predetermined  level.  At  that  time,  water  is  drained  at 
a  rate  equal  to  a  fraction  of  the  remaining  water  volume. 

36.  Because  the  flood/dry  scheme  transfers  water  from  cells  residing  in 
the  Navier-Stokes  computational  domain  to  cells  outside  this  domain,  disconti¬ 
nuities  or  noise  is  generated  in  the  flow  field  solution.  Noise  is  also 
generated  when  cells  are  added  to,  or  deleted  from,  the  computational  domain. 
Since  affected  cells  typically  have  low  water  levels,  resulting  in  high  bottom 
friction  effects,  noise  is  dampened  in  successive  time-step  calculations. 

37.  To  provide  sufficient  time  for  bottom  friction  to  dampen  noise,  and 
prevent  excessive  noise  generation  by  cells  repeatedly  entering  and  exiting 
the  Navier-Stokes  calculations,  time  constraints  are  imposed  on  the  flood/dry 
scheme.  That  is,  a  dry  cell  must  remain  dry  for  a  minimum  number  of  time- 
steps  before  flooding  can  occur.  Similarly,  a  "wet"  cell  must  remain  in  the 
computational  domain  for  a  minimum  number  of  time-steps  before  exiting  the 
computational  domain.  Experience  has  shown  that  a  time  period  of  5  min  for 
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storm  surge  studies  and  20  min  for  tidal  studies  is  sufficient  for  dampening 
noise . 

Barriers 

38.  Subgrid  barriers  refer  to  flow  field  obstructions,  such  as  breakwa¬ 
ters,  whose  widths  are  much  narrower  than  the  widths  of  adjacent  grid  cells, 
but  whose  lengths  are  at  least  as  great  as  the  length  of  a  grid  cell.  Though 
treated  as  impermeable,  barriers  can  go  through  alternating  periods  of  being 
submerged  and  exposed  during  a  tidal  cycle  or  storm  surge. 

39.  Barriers  are  categorized  into  three  types;  (a)  exposed, 

(b)  submerged,  and  (c)  overtopping.  Each  barrier  is  permitted  to  change 
categories  during  a  simulation,  thus  allowing  a  barrier  that  is  submerged 
during  periods  of  high  water  levels  to  become  exposed  after  the  water  levels 
have  receded.  Exposed  barriers  impose  a  no-flow  condition  where  velocities  at 
the  barrier  are  zero.  Submerged  barriers  are  included  in  the  Navier-Stokes 
computations  and  serve  as  starting  and  ending  points  for  computational 
segments . 

40.  Barrier  overtopping  occurs  when  (a)  water  levels  on  one  side  of  the 
barrier  are  higher  than  the  barrier,  while  levels  on  the  opposite  side  are 
lower  than  the  barrier,  or  (b)  when  water  levels  on  both  sides  of  a  barrier 
ire  higher  than  the  barrier,  but  levels  are  less  than  a  small  prescribe  level 
(i.e.  the  barrier  is  not  quite  submerged).  For  both  situations,  flow  dis¬ 
charges  across  a  barrier  are  computed  by  a  broad-crested  weir  formula  algo¬ 
rithm  similar  to  the  flood/ dry  scheme. 

41.  Discharge  volumes  are  subtracted  from  the  cell  whose  water  level  is 
above  the  barrier.  An  equal  volume  is  added  to  the  opposite  cell,  assuring 
that  water  volume  is  conserved  in  the  system.  Because  these  computations 
occur  after  the  Navier-Stokes  computations,  small  instabilities  are  generated. 
Similar  to  the  flood/dry  algorithm,  time  controls  are  imposed  to  ensure  that 
bottom  friction  effects  have  sufficient  time  for  dampening  these  instabili¬ 
ties.  Thus,  an  overtopping  barrier  must  remain  as  an  overtopping  barrier  for 
a  minimum  number  of  time -steps  and  a  submerged  barrier  must  remain  as  a 
submerged  barrier  for  a  minimum  number  of  time -steps.  The  number  of  time- 
steps  is  specified  by  the  user  and  has  a  default  value  of  five  time -steps. 
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PART  III:  DEFINITION  OF  INPUT  DATA  FORMAT 


42.  The  Input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  models  released  by  the  USAE  Hydrologic  Engineering 
Center.  It  is  the  intent  that  this  structure,  being  familiar  to  Corps 
personnel,  will  reduce  the  time  needed  to  learn  this  system.  The  general 
format  of  the  input  data  set  records,  where  a  record  refers  to  one  line  of 
data,  is  presented  below: 

a.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

fe.  Field  1,  columns  1  through  8,  contains  a  mnemonic  identifi¬ 
cation  label  that  describes  the  purpose  or  function  of 
each  record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right  justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  do  not  need  to  be  right-  or  left- 
justified. 

d-  Array  data,  such  as  depths,  are  read  with  DO  or  Implied  DO 

loops.  No  label  is  required  for  each  record  containing  array 
data.  However,  a  general  specification  record,  such  as  BATH- 
SPEC,  which  defines  bathymetric  attributes,  must  precede 
that  array. 

43.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution,  or  bypassing  of  desired 
user-defined  operations,  such  as  saving  time-history  data. 

44.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  simulation  or  required  by  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies  per¬ 
formed  by  CERC.  Although  these  quantities  may  not  be  applicable  to  all 
studies,  they  can  serve  as  a  guide  when  selecting  replacement  values. 

45.  Default  values  are  processed  when  the  record  field  corresponding  to 
that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving  fields 
blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a  variable 
being  assigned  a  value  of  zero.  These  variables  and  their  respective  default 
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values  are  noted  in  Appendix  4-A.  The  following  discussion  pertains  to  the 
general  format  of  the  Input  records  given  In  Appendix  4-A. 

46 .  Each  record  Is  presented  In  a  standardized  tabular  format  and  has 
as  Its  heading  the  mnemonic  Identification  label  or  name  with  a  brief  descrip¬ 
tion  of  Its  function.  Following  Its  name,  the  record  has  an  abbreviated  note 
documenting  whether  It  Is  required  for  a  simulation.  These  abbreviations  have 
the  following  definitions: 

(Req)  Record  or  variable  is  required  for  each  simulation. 

(Opt)  Record  or  variable  Is  optional.  Omitting  this  Item 

results  in  either  the  default  value  being  used  or  the 
defined  operation  not  being  performed. 

(C-opt)  Record  or  variable  is  required  if  related  or  parent 
options  have  been  selected. 

For  example,  record  TIMESPEC,  presented  in  Appendix  4-A,  contains  the  note 
(Req) ,  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt)  meaning  this  record  is 
optional  and  is  used  only  when  changes  to  the  bathymetric  data  are  desired. 
Record  XSTRETCH  contains  the  note  (C-opt),  meaning  this  record  is  required 
only  if  a  stretched  Cartesian  grid  has  been  specified  on  the  GRIDSPEC  record. 

47.  Input  variables,  presented  in  column  2  of  each  table,  are  refer¬ 
enced  to  their  respective  record  fields  shown  in  column  1.  Generally,  data 
for  each  variable  occupy  a  single  8-column  data  field.  However,  variables 
assigned  titling  or  formatting  information  can  occupy  several  fields. 

48.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  column  3  and  can  be  real,  integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up 
to  16  characters 

Char*8  Alphanumeric  character  string  containing  up 

to  8  characters 

Integer  Integer  data 

Real  Real  (floating  point)  data 

49.  Column  4  of  each  table  defines  whether  the  respective  variable  must 

be  assigned  a  value.  Abbreviations  listed  in  this  column  have  identical 
meanings  as  those  for  the  records.  Default  values  are  listed  in  column  5.  A 
blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 
assigned  a  default  value. 
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50.  Column  6  of  each  table  lists  the  variables'  permitted  data  type  or 
all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 
specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+1  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 

51.  Variable  definitions  are  listed  in  table  column  7  of  each  table. 
Variables  whose  quantities  are  unit -dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  TMAX  is 
assigned  a  value  having  units  defined  by  variable  TUNITS.  Variables  defining 
input  data  units,  and  on  which  record  they  reside,  are  presented  below. 


variable 

BUNITS 

tsecaro- 

BATHSPEC 

_ uermition _ 

bathymetry/topography  data 

FRUNIT 

FRICTION 

declares  bottom  friction  law 

FUNITS 

FUNCTION 

tidal  and  discharge  boundary  data 

GUNITS 

GRIDS PEC 

numerical  grid  data 

PUNITS 

WINDSPEC 

atmospheric  pressure  data 

SUNITS 

GENSPECS 

model  computations  and  output 

TUNITS 

TIMESPEC 

time -dependent  variables 

WUNITS 

WINDSPEC 

wind  velocity  data 

PART  IV:  DISCUSSION  OF  INPUT  DATA  REQUIREMENTS 


52.  The  types  of  data  processed  by  VIFM  are  extensive  and  encompass  a 
wide  range  of  possible  applications.  Since  each  application  is  unique,  the 
type  of  input  data  required  for  each  study  will  vary.  In  this  discussion  of 
model  input,  data  have  been  divided  into  six  categories  to  present  model  capa¬ 
bilities  and  data  requirements.  These  categories  are: 

&.  Model  control  specifications, 
k.  Grid  description. 

£..  Physical  characteristics. 

Boundary  conditions. 

£.  Wind-field  specifications, 
f.  Output  specifications. 

53.  Table  4-2  presents  WIFM  input  data  records  pertaining  to  each 
category.  A  record  refers  to  one  line  of  data,  and  each  record  begins  with  a 
mnemonic  character  string  to  identify  one  record  type  from  another.  Record 
format  and  detailed  specification  for  each  record  are  contained  in  Part  IV. 
While  reading  Part  IV,  the  user  will  find  it  beneficial  to  refer  to  Appen¬ 
dix  4-A. 


Model  Control  Specifications 

54.  Model  control  parameters  define  how  the  user  wants  to  control  the 
model's  execution.  Records  contained  in  this  category  include  GENSPECS, 
TIMESPEC,  STARTUP,  and  ADDTERMS . 

55.  Record  GENSPECS  is  used  to  specify  the  general  title  of  the  simula¬ 
tion  (TITLE)  and  the  system  of  units  (SUNITS)  used  for  model  computations  and 
displaying  model  results.  Variable  names  are  given  in  parentheses.  In 
addition  to  the  general  title,  other  input  data  records  have  provisions  for 
titles.  Although  this  information  is  optional,  it  can  be  very  helpful  when 
reviewing  a  series  of  simulations.  A  title  should  specifically  state  data  set 
attributes,  such  as  data  source  or  collection  date,  to  differentiate  it  from 
data  used  in  other  simulations. 

56.  Model  output  is  presented  in  either  English  or  metric  units. 
However,  the  user  can  specify  a  different  system  of  units  for  the  input  data. 
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Table  4-2 


Input  Data  Set  Records 


_ Category _  Record  Name 

Model  control  specifications  GENSPECS 

TIMESPEC 


STARTUP 

ADDTERMS 

Grid  description  GRIDSPEC 

XSTRETCH 

YSTRETCH 

TURNOFF 

Physical  characteristics  BATHSPEC 

CHNGBATH 

FDRYSPEC 

FRICTION 

FRICTABL 

CHNGFRIC 

XBARRIER 

YBARRIER 

BARRSPEC 


Boundary  conditions  XBOUNDRY 

YBOUNDRY 

FUNCTION 

CNRECORD 

CONSTIT 

TERECORD 

TFRECORD 

TABELEV 

TAB FLOW 

Wind- field  specifications  WINDSPEC 

SPHSPEC 
TABS PH 
TABWINDS 


Output  specifications  PRWINDOW 

RECGAGE 

RECSNAPS 

XRECRANG 

YRECRANG 
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For  example,  the  user  can  supply  wind  velocity  data  having  units  of  either 
miles  per  hour,  feet  per  second,  meters  per  second,  or  knots.  WXFM  will 
perform  the  necessary  conversion  to  place  the  input  data  into  the  system  of 
units  used  for  computations. 

57.  Record  TIMESPEC  controls  the  processing  of  all  time-related  vari¬ 
ables.  Variable  DELT  defines  the  time-step  or  time  interval  between  consecu¬ 
tive  flow  field  computations  and  has  units  of  seconds.  Variable  TUN1TS 
controls  the  units  of  all  other  time -dependent  variables  (e.g.,  variable 
DTGAGS) .  Valid  units  for  TUNITS  are  hours,  minutes,  and  seconds. 

58.  For  meaningful  model  results,  the  selected  time -step  must  be 
consistent  with  the  Courant  criteria,  Ct  ,  discussed  under  model  limitations. 
The  maximum  permissible  time-step  size  for  a  given  value  of  Ct  can  be 
computed  from: 


Cr 


Ax/  At 
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where 

g  -  gravitational  acceleration 

Ax  -  dimension  of  the  smallest  grid  cell  within  the  computational 
domain 

h  -  depth  at  that  cell 
At  -  time-step  size 

Experience  indicates  that  the  value  for  Ct  should  be  less  than  5.  Larger 
values  of  the  Courant  number  may  be  permissible  at  a  distance  from  the  area  of 
interest  within  the  computational  domain;  however,  numerical  accuracy  will  be 
affected. 

59.  Variable  TPROV  defines  the  provisional  model  time  at  the  start  of 
the  simulation,  and  variable  TMAX  controls  the  simulation's  duration.  TMAX 
must  be  an  integer  multiple  of  the  time-step,  variable  DELT.  Typically,  a 
simulation  begins  at  time  0.0  and  has  a  duration  ranging  from  one  to  several 
days.  This  duration  provides  the  hydrodynamic  model  sufficient  time  in  which 
to  develop  accurate  tidal  circulation  fields  and  avoids  the  generation  of 
numerical  instabilities  induced  by  instantaneously  applying  forces  to  a  static 
water  basin.  Additional  details  concerning  duration  are  discussed  with  tidal 
boundary  conditions. 

60.  Variable  DTGAGS  specifies  the  frequency  at  which  numerical  gage 
time-history  data  (i.e.,  water  velocities  and  free  surface  elevations)  are 
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saved  for  future  processing  by  the  post -processing  package  in  the  CMS. 
Quantities  assigned  to  this  variable  must  be  an  integer  multiple  of  the  time- 
step  variable  DELT.  Numerical  gage  locations  (locations  for  which  time- 
histories  are  saved)  are  selected  with  the  RECGAGES  record,  which  is  discussed 
in  the  model  output  specifications  section.  Variable  DTHOTS  defines  the  time 
interval  for  saving  field  data  for  use  in  another  simulation  (see  STARTUP 
record).  Quantities  assigned  to  this  variable  must  be  an  integer  multiple  of 
the  time -step  DELT. 

61.  The  STARTUP  record  defines  the  flow  field  conditions  at  the  stare 
of  a  simulation.  Normally,  the  flow  field  is  assumed  to  be  static  (SELEV-0) . 
Although  this  assumption  may  not  be  entirely  correct,  it  is  often  necessary 
because  prototype  data  rarely  have  the  resolution  to  accurately  define  the 
flow  field  throughout  the  model  domain  at  the  start  of  a  simulation.  To 
dampen  computational  instabilities  associated  with  static  initial  conditions, 
the  simulation  should  begin  several  hours  before  the  time  of  interest. 

62.  Initial  conditions  can  also  be  supplied  from  a  previous  simulation 
(SELEV  -  HOTSTART) .  These  simulations  must  be  sequential  in  time  since  the 
second  simulation  is  a  continuation  of  the  first.  When  initial  conditions  are 
supplied  from  a  previous  simulation,  the  second  simulation  is  referred  to  as  a 
"hotstart."  Slight  computational  inaccuracies  also  exist  for  hotstart 
conditions  due  to  data  round-off  incurred  by  storing  data  on  a  computer  disk. 
These  precision  errors  cause  instabilities  that  are  significantly  smaller  than 
those  generated  from  starting  with  static  conditions  and  can  be  minimized  by 
overlapping  the  simulations.  Overlapping  is  performed  by  saving  the  hotstart 
data  file  approximately  10  to  20  time -steps  before  the  end  of  the  first 
simulation.  The  second  simulation  is  then  run  with  this  hotstart  file.  When 
analyzing  model  results,  the  user  should  ignore  the  repeated  (overlapping) 
time -steps . 

63.  When  a  hotstart  is  selected,  variable  TPROV  on  record  TIMESPEC  must 
be  set  to  the  time  when  the  desired  field  data  were  saved.  These  times  are 
printed  in  the  input  data  summary  file  of  the  preceding  run.  The  hotstart 
simulation  will  begin  at  time  TPROV  and  end  at  time  TMAX  +  TPROV.  Therefore, 
the  user  should  not  incorporate  the  simulation  time  of  the  previous  run  into 
variable  TMAX.  All  remaining  time  variables  should  reflect  the  change  in 
starting  time.  The  STARTUP  record  also  contains  variable  SECHO.  A  brief  or 
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full  report  of  input  data  is  written  to  the  output  file  (FNPRNT)  by  specifying 
SECHO  equal  to  SHORT  or  DETAILED,  respectively. 

64.  Record  ADDTERMS  must  reside  in  the  input  data  set  if  either  the 
inertial  or  the  diffusion  terms  are  to  be  computed  in  the  Navier- Stokes  calcu¬ 
lations.  Variable  ADVTYP  is  set  to  NOADVECT  for  no  inertial  terms,  NONCONS  to 
include  inertial  terms  in  their  nonconservative  form,  or  CONSERV  to  include 
the  inertial  terms  in  their  conservative  form. 

65.  An  eddy  viscosity  coefficient  must  be  specified  if  diffusion  is 
computed.  Diffusion  is  set  with  variable  DIFTYP  equal  to  NODIFFUS  for  no 
diffusion,  CONSTDIF  for  diffusion  with  a  constant  eddy  viscosity  coefficient, 
or  VARDIF  for  diffusion  with  a  variable  eddy  viscosity  coefficient.  The  value 
of  the  eddy  viscosity  coefficient  is  defined  by  variable  DIFCOF  and  can  be 
constant  or  variable.  Rainfall,  groundwater  flow,  and  evaporation  are 
accounted  for  in  the  system  with  variable  ADMASS  on  the  ADDTERMS  record. 

Grid  Description 

66.  The  study  area  is  defined  in  the  model  via  a  computational  grid. 

The  grid  is  composed  of  rectilinear  cells,  where  each  cell  is  assigned  a  two- 
dimensional  index.  The  first  index  (i)  corresponds  to  the  x-coordinate ,  and 
the  second  index  ( j )  corresponds  to  the  y-coordinate .  The  grid  index  system 
is  presented  in  Figure  4-6.  All  flow  field  data,  such  as  depths,  are  assigned 
and  referenced  to  their  respective  grid  cells  with  this  system.  Guidelines 
for  developing  grids  are  discussed  in  Appendix  A  of  the  CMS  User's  Manual. 

67.  WIFM  permits  a  rectilinear  stretched  grid  coordinate  system,  where 
successive  grid  cells  can  smoothly  vary  in  width.  Grids  with  uniform  width 
cells  are  also  permitted.  Procedures  for  constructing  a  grid  are  presented  in 
documentation  of  package  CMSGRID  (Appendix  A  of  the  CMS  User's  Manual). 

CMSGRID  guidelines  for  grid  generation  pertaining  to  hydrodynamic  models  are 
therefore  useful  for  WIFM  applications . 

68.  Selection  of  grid  coordinate  systems  is  controlled  by  variable 
GRTYPE  on  record  GRIDSPEC.  A  uniform,  or  constant  grid  cell  size  is  selected 
by  assigning  the  character  string  RECTANG  to  variable  GRTYPE,  whereas  string 
RSTRETCH  selects  a  stretched  rectilinear  grid.  If  the  stretched  grid  option 
is  selected,  record  GRIDSPEC  must  be  followed  by  a  set  of  XSTRETCH  and 
YSTRETCH  records  (Table  4-3).  These  records  are  generated  by  the  interactive 
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Figure  4-6.  Definition  of  coordinate  system 
and  grid  cell  convention 


Table  4-3 

Sample  XSTRETCH  and  YSTRETCH  Records 


XSTRETCH 

1 

4 

-.696333695 

.696333695 

.933460501 

XSTRETCH 

4 

9 

-6.69031772 

5.80606023 

.277821490 

XSTRETCH 

9 

19 

.143110486 

.710267924 

.770050578 

XSTRETCH 

19 

26 

.167892340 

.730987967 

.809764231 

XSTRETCH 

26 

45 

.188997542 

.786653891 

.897775643 

YSTRETCH 

1 

17 

- . 500000000 

. 500000000 

1 . 00000000 

YSTRETCH 

17 

26 

.177832310 

.755987967 

.823454231 

YSTRETCH 

26 

35 

. 500000000 

. 500000000 

1 . 00000000 

YSTRETCH 

35 

47 

.199875847 

.788797546 

.887865638 

YSTRETCH 

47 

55 

6.89654455 

5.77767885 

.277896445 

YSTRETCH 

55 

70 

.123478445 

.556789654 

.234564567 

grid  generation  program  MAPIT  contained  in  package  CMSGRID  and  can  be  placed 
directly  into  the  input  data  set  without  modification.  The  reader  can  refer 
to  Appendix  A  of  the  CMS  User's  Manual  for  more  information  on  XSTRETCH  and 
YSTRETCH . 

69.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  computational  grid.  Valid  units  are  ENGLISH  and  METRIC.  WIFM  will 
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convert  the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 
Variables  XCELL5  and  YCELLS  specify  the  number  of  grid  cells  in  the  x-  and  y- 
directions,  respectively.  Variables  DX  and  DY  on  record  GRIDSPEC  specify  a 
grid’s  spatial  mapping  scale  in  the  x-  and  y-directions,  respectively.  For 
uniform  grids  that  were  not  generated  by  program  MAPIT,  these  variables  are 
assigned  the  physical  width  of  a  single  cell.  For  stretched  rectilinear 
grids,  variables  DX  and  DY  are  assigned  the  value  1.0  if  physical  distances 
were  used  in  generating  the  grid.  The  variables  DX  and  DY  are  assigned  the 
value  of  the  map  scale  if  relative  map  distances  were  used  in  generating  the 
grid.  For  example,  a  map  with  a  scale  of  1:80,000  is  used  to  generate  a 
stretched  rectangular  grid.  If  the  physical  map  distances  (i.e.,  distances 
computed  using  the  appropriate  scaling)  are  used  to  generate  the  mapping 
coefficients,  then  DX  and  DY  are  1.0  because  no  conversion  is  necessary. 
However,  if  the  map  distances  (i.e.  grid  distances  measured  in  map  inches)  are 
used  to  generate  the  mapping  coefficients,  then  DX  and  DY  must  be  6666.67  to 
convert  map  inches  to  physical  distances  (in  feet). 

70.  Variables  GLATT  and  GL0NG  specify  the  latitude  and  longitude  of  the 
grid  origin  in  decimal  degrees,  respectively.  GALIGN  specifies  the  counter¬ 
clockwise  rotation  of  the  x-axis  from  due  east  (in  decimal  degrees). 

71.  Because  of  manpower  costs  associated  with  development  of  a  computa¬ 
tional  grid,  a  user  should  construct  a  grid  with  conservative  limits  in  the 
lateral  and  longshore  directions.  Grid  dimensions  can  then  be  minimized  with 
record  TURNOFF.  This  record  permits  a  user  to  remove  entire  rows  or  columns 
of  cells  from  the  Navier-Stokes  and/or  flood-dry  calculations  along  a  grid 
boundary  without  generating  a  new  grid.  When  boundary  cells  are  removed, 
boundary  conditions  must  be  moved  accordingly.  Variables  (0FFX1 ,0FFY1)  and 
(0FFX2 ,0FFY2)  define  the  "patch"  of  cells  to  be  removed  from  computations. 
Variables  0FFX1  and  0FFX2  on  the  TURNOFF  record  specify  the  minimum  and 
maximum  cell  numbers  in  the  x-direction,  respectively,  where  cells  will  be 
removed  from  the  computations.  Similarly,  variables  0FFY1  and  0FFY2  on  the 
TURNOFF  record  specify  the  minimum  and  maximum  cell  numbers  in  the  y- 
direction,  respectively,  where  cells  will  be  removed  from  the  computations. 
More  than  one  TURNOFF  record  is  permitted. 

72.  When  this  record  is  applied  to  cells  within  the  grid  interior,  the 
model  will  treat  these  cells  as  land  that  will  never  flood.  A  zero  flux 
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boundary  condition  is  iaposed  at  the  faces  of  removed  cells.  Though  cells  are 
removed  using  this  record,  the  grid  cell  numbering  scheme  is  not  affected. 


Physical  Characteristics 

73.  A  study  area's  physical  characteristics  include  its  (a)  topog¬ 
raphy/bathymetry  values,  (b)  bottom  friction  coefficients,  (c)  flooding  and 
drying  parameters,  and  if  applicable,  (d)  any  barriers  or  obstructions 
influencing  tidal  circulation  or  storm  surge  levels.  Records  pertaining  to 
each  of  the  above  topics  are  described  individually  in  the  following  sections. 
Topography /bathymetry 

74.  Each  grid  cell  must  be  assigned  a  water  depth  or  land  elevation. 
Topography /bathymetry  data  are  referenced  relative  to  an  arbitrary  datum. 
Typically,  the  map  datum  from  which  the  depths  are  taken  is  used.  Uater  cells 
are  designated  by  negative  values,  whereas  land  cells  have  positive  values. 

75.  One  BATHSPEC  record  is  required  for  defining  the  general  charac¬ 
teristics  of  the  topography/bathymetry  array  and  must  precede  this  array. 
Variable  BUNITS  defines  the  units  of  topography/bathymetry  data.  Valid  units 
are  feet,  meters,  or  fathoms.  The  input  sequence  for  reading  this  array  is 
controlled  by  variable  BSEQ.  Eight  options  for  the  input  sequence  are 
available  for  reading  the  array  data  and  are  documented  in  Table  4-4.  As  an 
example,  for  the  first  input  sequence  (Figure  4-7),  the  depths  are  read  along 
the  x-direction;  then  y  is  incremented  to  a  value  of  2,  and  again  the  sweep  in 
the  x-direction  takes  place.  This  procedure  is  repeated  until  the  entire 
array  is  read.  The  input  format  for  reading  this  array  can  be  selected  by  the 
user  with  variable  BFORM. 

76.  The  maximum  water  depth  is  specified  with  variable  DLIM1T,  and  any 
array  values  deeper  than  DLIMIT  are  set  to  DLIMIT  (in  BUNITS).  Grid-wide 
adjustments  to  land  elevations  contained  in  the  topography/bathymetry  array 
can  be  made  with  variable  LDATUM.  The  value  assigned  to  this  variable  is 
added  to  all  land  cells  in  the  grid.  Positive  LDATUM  values  will  increase 
land  elevations,  whereas  negative  values  will  decrease  land  elevations. 
Similarly,  grid-wide  adjustments  to  water  depths  can  be  made  with  variable 
WDATUM.  The  value  assigned  to  this  variable  is  added  to  all  water  cells. 

Since  these  cells  have  negative  values,  positive  WDATUM  values  produce 
shallower  basins. 
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Table  4-4 


Input  Sequence  for  Array  Data 


Es 

SeqwTKg 

Description 

l 

XY 

1 

DO  1  J-l, YCELLS 

READ (LUN, FORM)  (VAR(I ,J) , 1-1 .XCELLS) 

2 

-XY 

2 

DO  2  J-l.YCELLS 

READ (LUN, FORM)  (VAR( I , J ) , I-XCELLS ,1,-1) 

3 

X-Y 

3 

DO  3  J-YCELLS ,1,-1 

READ (LUN, FORM)  (VAR(I ,J) , 1-1 .XCELLS) 

4 

-X-Y 

4 

DO  4  J-YCELLS, 1,-1 

READ  ( LUN , FORM )  ( VAR ( I , J ) , I-XCELLS ,1,-1) 

5 

YX 

5 

DO  5  1-1, XCELLS 

READ  (LUN, FORM)  (VAR(I , J) , J-l , YCELLS) 

6 

-YX 

6 

DO  6  I -1, XCELLS 

READ (LUN , FORM)  (VAR(I,J) , J-YCELLS , 1 ,- 1 ) 

7 

Y-X 

7 

DO  7  I-XCELLS, 1,-1 

READ (LUN, FORM)  (VAR( I ,J) , J-l .YCELLS) 

8 

-Y-X 

8 

DO  8  I-XCELLS, 1,-1 

READ (LUN, FORM)  (VAR(I,J) , J-YCELLS , 1 ,- 1 ) 

Figure  4-7.  Input  sequence  -  option  1 
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77 .  Changes  to  the  topography/bathyaetry  array  can  also  be  made  to 
Individual  cells  or  to  a  group  of  cells  with  record  CHNGBATH.  This  record 
allows  the  user  to  quickly  change  values  assigned  to  the  bathymetry  array 
(using  variable  BATH)  without  editing  the  array  itself.  It  should  be  noted 
that  (a)  values  of  the  variable  BATH  on  the  CHNGBATH  record  are  assumed  to 
have  units  consistent  with  those  selected  for  bathymetry/topography  (i.e., 
variable  BUNITS  on  record  BATHSPEC) ,  and  (b)  LDATUM  and  WDATUM  are  not  applied 
to  cells  specified  with  record  CHNGBATH;  therefore,  the  effect  of  nonzero 
LDATUM  and  WDATUM  must  be  included  in  the  value  of  variable  BATH. 

78.  Variables  X1INDX  and  X2INDX  on  the  CHNGBATH  record  specify  the 
minimum  and  maximum  cell  numbers  in  the  x-direction,  respectively,  where  the 
bathymetry/topography  value  will  change.  Similarly,  variables  Y1INDX  and 
Y2INDX  on  the  CHNGBATH  record  specify  the  minimum  and  maximum  cell  numbers  in 
the  y-direction,  respectively,  where  the  bathymetry/topography  value  will 
change.  More  than  one  CHNGBATH  record  is  permitted. 

Flooding  and  drying 

79.  Flood/ dry  calculations  are  made  only  at  those  cells  whose  eleva¬ 
tions/depths  are  within  the  limits  defined  by  variables  ALLDRY  and  ALLWET  on 
the  FDRYSPEC  record  (Figure  4-8).  Cells  having  elevations  greater  than  ALLDRY 
remain  as  dry  land  and  are  not  checked  for  flooding,  whereas  cells  whose 
depths  are  deeper  than  ALLWET  remain  as  water  cells  and  are  not  checked  for 
drying. 

80.  Variables  ALLDRY  and  ALLWET  are  assigned  conservative  default 
values  of  30.0  and  -20.0  ft,  respectively.  Because  cells  are  checked  for 
flooding  and  drying  every  time-step,  a  narrower  range  of  values  reduces  the 
number  of  cells  to  be  checked  and  can  significantly  reduce  the  execution  time 
of  a  simulation.  However,  default  values  should  not  be  changed  arbitrarily. 

If  variable  ALLDRY  is  set  too  low,  cells  that  would  ordinarily  flood  during 
the  course  of  rising  water  levels  are  prevented  from  doing  so.  This  results 
in  underestimating  the  extent  of  inundation  within  the  study  area  and  overes 
timating  water  levels  in  "wet"  cells  adjacent  to  the  shoreline.  Similarly,  if 
variable  LWET  is  too  high,  cells  which  should  be  dry  are  forced  to  remain  in 
the  Navier- Stokes  computations  causing  the  model  to  go  unstable  or  produce 
results  that  are  meaningless  (and  often  go  undetected).  This  possibility  is 
extremely  dangerous  because  all  subsequent  Navier-Stokes  computations  will  be 
affected . 
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Figure  4-8.  Limits  of  the  flooding 
and  drying  range 


81.  Determining  new  limits  can  be  made  by  performing  a  series  of  "worst 
case"  simulations.  In  these  simulations,  conservative  flood/dry  limits  are 
chosen,  and  the  model  is  run  with  those  storms  or  events  that  will  produce  the 
highest  flood  and  the  lowest  dry  elevations.  The  maximum  and  minimum  water 
levels  experienced  at  each  cell  are  printed  in  the  input  data  summary.  These 
values  are  measured  relative  to  each  cell's  bottom  and  should  be  added  to  the 
depth  array  for  determining  appropriate  limits. 

82.  Several  criteria  must  be  met  before  a  dry  cell  can  be  included  in 
the  Navier-Stokes  computations: 

a.  A  cell's  water  level,  measured  relative  to  its  bottom,  must 
exceed  a  prescribed  minimum  values. 

fe.  A  cell  must  be  dry  for  a  predetermined  length  of  time,  and  that 
time  must  exceed  one  time -step. 

Variable  CEPSD  on  record  FDRYSPEC  defines  the  minimum  water  level  needed  for 
inclusion  of  dry  cells  into  the  Navier-Stokes  computations.  Acceptable  values 
based  on  experience  range  from  0.2  to  0.5  ft,  measured  relative  to  the  bottom 
of  the  cell. 

83.  A  cell  is  removed  from  the  Navier-stokes  computations  if  its  water 
level  falls  below  one-half  of  variable  CEPSD' s  quantity  and  if  it  has  remained 
in  the  Navier-Stokes  calculations  for  at  least  the  period  of  time  defined  by 
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variable  TIMOPN.  This  variable  is  generally  assigned  a  value  of  5  min  for 
storm  surge  and  20  min  for  tidal  circulation  studies.  Similarly,  variable 
TIMCLS  specifies  the  minimum  time  period  required  for  a  cell  to  remain  dry 
before  it  can  be  included  in  the  Navier- Stokes  computations.  This  variable  is 
generally  assigned  a  value  of  5  min  for  storm  surge  applications  and  20  min 
for  tidal  circulation  studies. 

84.  Variable  CFWEIR  is  a  weir  coefficient  for  cell  flooding  and  drying. 
The  value  of  CFWEIR  is  used  for  the  admittance  (or  weir)  coefficient,  C0  ,  in 
Equation  4-21  and  has  a  default  value  of  4.0. 

85.  Variable  CDRAIN  is  a  recession  coefficient  specifying  the  volumet¬ 
ric  rate  at  which  water  is  drained  from  one  cell  to  an  adjacent  cell.  This 
value  is  expressed  as  a  fraction  of  the  total  water  volume  contained  in  the 
cell.  For  example,  a  value  of  0.10  results  in  10  percent  of  the  water  volume 
contained  in  a  cell  being  drained  after  each  time -step.  Typical  values 
assigned  to  variable  CDRAIN  range  from  0.10  to  0.20.  The  default  value  for 
CDRAIN  is  0.1.  Values  greater  than  0.20  may  result  in  numerical  instabilities 
if  the  transferred  water  volume  appreciably  raises  the  receiving  cell's  water 
level.  Therefore,  values  greater  than  0.20  should  not  be  used. 

Bottom  friction  coefficient 

86.  Several  choices  are  available  for  specifying  bottom  friction 
parameters.  First,  parameters  may  be  expressed  with  either  a  Chezy  friction 
loss  coefficient  or  a  Manning's  friction  factor.  This  designation  is  made 
with  variable  FRUNIT  on  record  FRICTION.  The  model,  which  uses  the  Chezy 
friction  loss  coefficient  in  the  bottom  friction  calculations,  converts 
Manning's  n  friction  factors  into  Chezy' s  Ct  coefficients  by  the  following 
relationship ; 

C  =  £1  (4-33) 

*  n 


where 

Cz  -  Chezy  friction  loss  coefficient 
d  -  total  water  depth 
n  -  Manning's  friction  factor 

Quadratic  friction  is  the  only  option  presently  available  in  WIFM  and  is 
specified  by  setting  FRLAW  to  QUADRAT  on  record  FRICTION. 
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87.  Bottom  friction  coefficients  may  be  specified  as  constant  values 
(FRDEF  -  CONSTANT)  or  as  functions  of  depth/elevation  (FRDEF  -  VARYBATH) .  For 
the  constant  value  option,  separate  friction  coefficients  can  be  assigned  to 
land  and  water  cells.  Friction  coefficients  for  land  are  assigned  to  variable 
FRLAND,  and  coefficients  for  water  cells  are  specified  by  variable  FRWATR.  A 
coefficient  is  assigned  to  each  cell  based  on  its  topography /bathymetry  value 
at  the  start  of  a  simulation  and  will  remain  constant  throughout  the  simula¬ 
tion,  regardless  of  flooding/drying  effects. 

88.  The  depth-variable  friction  option  requires  a  least  two  FRICTABL 
records,  which  must  iollow  immediately  after  the  FRICTION  record  in  the  input 
data  set.  Each  FRICTABL  record  must  contain  a  depth/elevation  (FDEPTH)  and  a 
corresponding  friction  value  (FRICT)  for  creating  a  tabular  friction  function. 
Cells  with  a  water  depth  less  than  or  equal  to  FDEPTH  are  assigned  a  friction 
value  of  FRICT.  Cells  whose  depths  are  deeper  than  the  minimum  depth  entered 
in  the  table  are  assigned  the  friction  coefficient  corresponding  to  the 
minimum  table  depth. 

89.  In  deep  water,  bottom  friction  has  a  negligible  effect  on  long-wave 
hydrodynamics.  Variable  FDMAX  on  record  FRICTION  defines  the  maximum  depth 
where  bottom  friction  influences  the  hydrodynamics.  It  is  provided  for 
reducing  computer  memory  requirements  when  the  depth-variable  option  is 
requested  and  has  a  default  value  of  -300.0  ft. 

90.  Friction  coefficients  can  also  be  assigned  to  individual  cells  or  a 
group  of  cells  with  record  CHNGFRIC.  Record  CHNGFRIC  overrides  the  above 
options  for  all  cells  entered  on  this  record.  This  permits  the  user  to  change 
a  cell's  friction  coefficient  in  certain  areas,  such  as  rivers,  where  parame¬ 
ters  differ  from  the  norm.  Friction  coefficients  (FRICT)  defined  on  this 
record  must  be  consistent  with  the  bottom  friction  law  selected  (i.e.,  Chezy 
or  Manning  coefficient)  selected  by  variable  FRUNIT  on  record  FRICTION. 
Variables  (X1INDX,  YlINDX)  and  (X2INDX,  Y2INDX)  define  the  "patch"  of  cells 
where  friction  values  are  to  be  changed.  More  than  one  CHNGFRIC  can  be  used 
in  a  simulation.  These  records  must  follow  FRICTION  and,  if  applicable, 
FRICTABL  records. 

Barriers 

91.  Subgrid  barriers  refer  to  flow  field  obstructions,  such  as  breakwa¬ 
ters,  whose  widths  are  much  narrower  than  the  widths  of  adjacent  grid  cells, 
but  have  lengths  that  are  equal  to  or  greater  than  those  of  a  grid  cell. 
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Though  treated  as  impermeable,  barriers  can  go  through  alternating  periods  of 
being  submerged  and  exposed  during  a  tidal  cycle  or  storm  surge. 

92.  Records  pertaining  to  subgrid  barriers  include  XBARRIER,  YBARRIER, 
and  BARRSPEC.  Similar  to  the  flood/dry  parameters  discussed  previously,  many 
of  the  parameters  governing  overtopping  rates  have  been  determined  through 
modeling  experience.  Default  values  are  provided  for  these  terms,  and  it  is 
recommended  that  the  user  not  change  these  values  unless  there  is  just  cause 
for  doing  so.  Discharge  rates  across  a  barrier  can  be  stored  with  either 
records  XRECRANG  or  YRECRANG  and  are  discussed  under  model  output 
capabilities . 

93.  Barriers  that  prevent  or  impede  flow  in  the  x-direction  (i.e., 
perpendicular  to  the  x-axis)  are  specified  with  XBARRIER  records  (Figure  4-9). 
A  barrier  for  a  particular  cell  is  defined  at  the  cell  face,  where  the 
velocity  is  also  defined.  Barrier  grid  locations  are  defined  with  variables 
BRP0S1 ,  BRP0S2 ,  and  BRP0S3 .  Variable  BRP0S1  is  assigned  the  barrier's  grid 
cell  X- index,  and  variables  BRP0S2  and  BRP0S3  are  assigned  the  barrier's 
starting  and  ending  grid  cell  Y-indices,  respectively. 

94.  Similarly,  YBARRIER  records  define  those  barriers  that  prevent  or 
impede  flows  in  the  y-direction.  Variable  BRP0S1  is  assigned  the  barrier's 
grid  cell  Y-index.  Variables  BRP0S2  and  BRP0S3  are  assigned  the  barrier's 
starting  and  ending  grid  cell  X- indices. 
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Figure  4-9.  Definition  of  XBARRIER  and  YBARRIER 
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95.  A  barrier's  crest  elevation,  assigned  to  variable  BARHT,  is 
measured  from  the  water-level  datum  to  the  barrier's  crest.  For  example,  a 
barrier  crest  of  2.0  ft  means  that  the  top  of  the  barrier  is  2.0  ft  above  the 
datum.  Conversely,  a  value  of  -2.0  ft  sets  the  crest  at  2.0  ft  below  the 
datum.  These  values  need  not  be  modified  for  hotstart  simulations. 

96.  Barriers  are  categorized  into  three  types:  exposed,  submerged,  and 
overtopping.  Each  barrier  is  permitted  to  change  categories  during  a  simu¬ 
lation,  allowing  a  barrier  that  is  submerged  during  periods  of  high  water  to 
become  exposed  after  the  water  level  has  receded.  Exposed  barriers  impose  a 
no -flow  condition  where  velocities  at  the  barrier  equal  zero.  Submerged 
barriers  are  included  in  the  Navier-Stokes  computations. 

97.  Barrier  overtopping  occurs  when  (a)  water  levels  on  one  side  of  the 
barrier  are  higher  than  the  barrier,  while  levels  on  the  opposite  side  are 
lower  than  the  barrier,  or  (b)  when  water  levels  on  both  sides  of  a  barrier 
are  higher  than  the  barrier,  but  levels  are  less  than  a  small  prescribed  level 
(not  yet  considered  submerged).  For  both  situations,  flow  discharges  across  a 
barrier  are  computed  with  a  broad-crested  weir  formula  algorithm  similar  to 
the  flood/dry  scheme. 

98.  Discharge  volumes  are  subtracted  from  that  cell  whose  water  level 
is  above  the  barrier.  An  equal  volume  is  added  to  the  opposite  cell,  assuring 
that  water  volume  is  conserved  in  the  system.  Because  these  computations 
occur  after  the  Navier-Stokes  computations,  small  instabilities  are  generated. 
Thus,  time  controls  are  imposed  to  ensure  that  bottom  friction  effects  have 
sufficient  time  for  dampening  these  instabilities. 

99.  Crests  of  submerged  barriers  are  assigned  a  Manning's  n  friction 
coefficient  with  variable  BARMAN  on  record  XBARRIER  or  YBARRIER.  This 
coefficient  is  independent  of  those  options  and  quantities  assigned  to  grid 
cells  with  records  FRICTION,  FRICTABL,  and  CHNGFRIC.  The  default  value  for 
variable  BARMAN  is  0.025.  Because  surfaces  of  man-made  barriers  tend  to  be 
rough  in  comparison  with  the  surrounding  area,  this  variable  may  need  to  be 
assigned  a  higher  friction  coefficient. 

100.  Variable  BARCOF,  similar  to  variable  CFWEIR  in  the  flood-dry 
algorithm,  is  the  admittance  or  weir  coefficient  in  the  broad-crested  weir 
formula.  This  variable  is  initialized  to  a  default  value  of  2.7  (English)  or 
4.9  (metric).  Barriers  can  be  identified  by  assigning  each  one  a  barrier  name 
with  variable  BARNAM  on  the  XBARRIER  or  YBARRIER  records. 
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101.  Overtopping  control  parameters  (variables  BEPSD,  TIMSUB,  and 
TIMOVT)  are  specified  on  record  BARRSPEC  and  are  applicable  to  each  barrier. 
(The  BARRSPEC  record  should  follow  all  XBARRIER  and  YBARRIER  records . ) 

Variable  BEPSD  prescribes  the  water  surface  level,  measured  relative  to  a 
barrier's  crest,  to  initiate/terminate  overtopping  computations.  Once  water 
levels  in  both  adjacent  cells  exceed  this  value,  the  barrier  will  be  treated 
as  submerged.  Similarly,  if  the  water  level  of  one  cell  falls  below  this 
value,  a  submerged  barrier  will  then  be  treated  as  an  overtopping  barrier. 

102.  Due  to  stability  considerations  discussed  previously,  a  barrier  is 
not  permitted  to  change  categories  every  time- step.  The  minimum  time  period 
before  a  submerged  barrier  can  become  an  overtopping  barrier,  and  vice  versa, 
is  controlled  by  variable  TIMSUB.  Similarly,  variable  TIMOVT  specifies  the 
minimum  time  period  required  before  an  overtopping  barrier  can  become  an 
exposed  barrier  (and  vice  versa) .  Typical  times  assigned  to  these  variables 
are  5  min  for  storm  surge  applications  and  20  min  for  tidal  circulation 
studies.  A  generalized  default  value  of  5  times  the  time-step  is  built  into 
the  model . 


Boundary  Conditions 

103.  WIFM  is  generally  applied  in  regions  where  at  least  one  grid 
boundary  lies  in  open  water.  For  example,  in  open  coast  regions,  the  seaward 
boundary  may  be  located  at  the  continental  shelf.  In  these  cases,  the  flow 
field  is  typically  driven  or  forced  by  prescribing  a  time-series  of  water 
surface  levels  along  this  boundary  throughout  a  simulation.  Regions  may  also 
contain  a  river  whose  flow  influences  local  circulation  patterns.  These  river 
flow  rates  can  be  specified  as  a  function  of  time.  Other  forcing  functions 
can  include,  for  storm  surges  induced  by  hurricanes,  the  atmospheric  pressure 
anomaly . 

104.  To  encompass  as  many  modeling  scenarios  as  possible,  four  types  of 
open  boundary  conditions  are  incorporated  into  this  model,  including: 

fl.  Tidal  elevation. 

}*.  Discharge. 

£.  Inverted  barometer. 

4-  Uniform  flux  conditions. 
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Discussion  of  these  open  boundary  conditions  is  presented  in  three  parts. 
First,  an  overview  of  each  type  of  open  boundary  is  given  which  describes  its 
application  and  attributes.  Second,  input  data  requirements  for  defining  a 
boundary's  grid  location  are  presented.  Third,  input  data  requirements  for 
entering  time -series  data  are  described. 

Overview  of  open  boundary  conditions 

105.  With  the  tidal  elevation  boundary  condition,  the  flow  field  is 
driven  by  specifying  the  water  surface  elevations  as  a  function  of  space  and 
time  along  a  grid's  outer  boundary.  Water  surface  elevations  are  measured 
relative  to  the  topography/bathymetry  datum  and  can  be  supplied  from  tidal 
constituent  parameters  or  tabulated  data. 

106.  Two  options  are  available  for  specifying  the  spatial  distribution 
of  data  along  a  boundary.  The  first  option  applies  a  spatially  constant 
elevation  function  across  a  boundary  segment  where  each  cell  in  the  segment 
acts  in  unison,  having  identical  water  surface  elevations  at  each  time-step. 
This  option  is  normally  applied  along  a  grid's  lateral  boundary  (i.e., 
perpendicular  to  the  shoreline)  in  areas  of  deep  water.  It  can  also  be  used 
along  a  seaward  boundary  if  no  significant  phase  or  elevation  differences 
occur  along  this  segment. 

107.  The  second  option  is  a  spatially  variable  elevation  forcing  boun¬ 
dary  where  separate  time -series  functions  are  specified  at  each  end  of  a 
boundary  segment.  Elevations  for  each  cell  within  the  boundary  are  obtained 
by  linearly  interpolating  the  two  forcing  functions  (at  each  time-step).  This 
option  is  typically  applied  along  the  grid's  seaward  boundary.  A  boundary  can 
be  treated  as  one  continuous  segment  or  as  several  segments. 

108.  With  the  inverted  barometer  boundary  condition,  the  flow  field  is 
driven  with  the  atmospheric  pressure  anomaly.  For  example,  as  the  barometric 
pressure  in  a  study  area  decreases,  an  increase  in  water  level  occurs  as  water 
is  drawn  into  the  area  from  outlying  seas.  Conversely,  an  increase  in 
barometric  pressure  forces  water  out  of  the  study  area,  resulting  in  lower 
water  levels.  Because  circulation  induced  by  barometric  pressure  differences 
during  calm  weather  are  small  compared  with  other  forcing  mechanisms  such  as  a 
tide,  its  use  has  been  limited  to  storm  surge  applications  performed  in 
conjunction  with  model  SPH. 

109.  For  simulations  where  a  tidal  signal  is  specified  at  a  boundary 
and  hurricane  wind  fields  are  computed  with  model  SPH,  model  WIFM  will  add  the 
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tidal  elevation  to  the  atmospheric  pressure  anomaly  to  simulate  the  combined 
effects.  However,  this  procedure  is  valid  only  in  areas  of  deep  water.  In 
this  situation,  the  boundary  should  be  specified  as  a  tidal  boundary  condi¬ 
tion.  Model  WIFM  will  internally  determine  whether  to  combine  the  two 
effects . 

110.  Discharge  boundary  conditions  can  be  specified  at  any  interior 
grid  cell  face.  An  error  message  will  be  printed  and  execution  terminated  if 
this  boundary  condition  is  specified  at  the  edge  of  the  computational  grid. 
Furthermore,  depths  on  each  side  of  the  boundary  cell  faces  must  be  less  than 
zero,  signifying  water  cells.  Discharges  are  required  to  have  units  of  flow 
per  unit  width  (i.e.,  cubic  feet/second/foot  or  cubic  meters/second/meter), 
and  flow  trajectories  are  referenced  relative  to  the  grid  axes.  Positive 
discharge  rates  define  flows  directed  in  the  positive  x-  or  y-directions , 
whereas  negative  discharge  rates  define  flows  directed  in  the  negative  x-  or 
y-direction. 

111.  A  uniform  flux  boundary  condition  is  similar  to  a  river  discharge 
boundary  condition  in  that  a  flux  is  applied  at  the  boundary  cell  face. 
However,  the  flux  through  the  cell  face  is  computed  internally  by  the  model, 
as  opposed  to  a  user-defined  flux.  This  boundary  condition  assumes  that  the 
flux  through  the  boundary  cell  face  equals  the  flux  through  the  opposing  cell 
face . 

112.  Since  the  uniform  flux  boundary  condition  does  not  drive  a  flow 
field,  its  application  is  limited.  However,  there  are  two  situations  where  it 
can  be  applied.  First,  it  can  be  applied  across  the  lateral  boundaries  near 
the  shoreline  (Figure  4-10).  Tidal  signals  generated  from  constituents,  which 
are  normally  prescribed  as  a  forcing  function  along  the  seaward  boundary, 
should  not  be  used  in  this  reach  because  bottom  friction  effects  attenuate  the 
tidal  signal.  Hence,  forcing  a  tidal  signal  in  this  reach  may  not  accurately 
depict  the  physical  processes  occurring  within  the  study  area. 

113.  Second,  the  uniform  flux  boundary  condition  may  be  applicable  to 
steady-state,  storm  surge  analyses  of  lakes.  However,  wind  must  be  the  only 
driving  force  causing  surge,  and  resulting  seiches  cannot  be  simulated  with 
this  boundary  condition. 

114.  Because  the  uniform  flux  boundary  condition  provides  an  estimate 
of  the  actual  flow  entering/exiting  the  grid,  its  use  will  introduce  error 
into  the  flow  field  solution.  Bottom  friction  effects  can  dampen  these 
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Shoreline 


Figure  4-10.  Uniform  flux  boundary  condition 


inaccuracies,  ensuring  accuracy  of  results  in  the  area  of  interest,  if  the 
uniform  flux  boundaries  are  placed  a  suitable  distance  away  from  the  area  of 
interest.  Generally,  this  distance  ranges  from  1.5  to  2.0  times  that  distance 
measured  from  the  shoreline  to  the  seaward  boundary  (if  it  is  located  at  the 
continental  shelf).  However,  it  is  suggested  that  the  user  perform  a  series 
of  sensitivity  tests  to  determine  whether  this  estimate  is  valid  for  their 
application  (Butler  1982) . 

115.  In  the  first  sensitivity  test  simulation,  the  model  should  be 
executed  with  the  boundary  conditions  specified  along  the  grid  boundary. 
Time-series  data  should  be  stored  at  several  grid  locations  that  envelop  the 
area  of  interest.  A  second  simulation  should  then  be  performed  with  the 
boundary  specified  several  rows  or  columns  inward  from  the  outer  grid  bound¬ 
ary.  All  cells  outside  the  "new"  grid  boundary  must  be  removed  from  the 
Navier-Stokes  and  flood-dry  computations  (refer  to  record  TURNOFF).  Time- 
series  data  should  again  be  stored  at  the  same  grid  locations. 

116.  Water  velocity  data  saved  from  these  simulations  should  then  be 
compared.  Should  differences  between  data  at  any  gage  consistently  exceed  a 
small  prescribed  value,  then  the  outer  boundary  is  too  close  to  the  area  of 
interest  to  use  the  uniform  flux  boundary  condition.  Thus,  the  user  must 
develop  another  grid.  If,  however,  velocity  differences  are  within  the  given 
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range,  additional  simulations  can  be  performed  to  reduce  computer  costs  by 
eliminating  unneeded  rows  and/or  columns  along  the  grid  boundary. 

Spatial  description  of  open  boundaries 

117.  Each  distinct  open  boundary  must  be  declared  by  either  an  XBOUNDRY 
or  a  YBOUNDRY  record.  Record  XBOUNDRY  defines  a  boundary  that  induces  or 
forces  flow  in  the  x-direction  (i.e.,  boundary  is  perpendicular  to  the  x-axis) 
(Figure  4-11).  Conversely,  a  YBOUNDRY  record  defines  a  boundary  whose  forcing 
acts  in  the  y-direction. 

118.  Boundary  types  are  declared  on  records  XBOUNDRY  and  YBOUNDRY  with 

variable  BNDTYP  and  can  be  assigned  any  of  the  five  options  previously 
discussed:  (a)  spatially  constant  tide  boundaries  are  selected  with  character 

string  CONSTELV,  (b)  spatially  variable  tide  boundaries  are  chosen  with  string 
INTRPELV,  (c)  spatially  constant  discharge  boundaries  are  selected  with  string 
CONSTDIS,  (d)  inverted  barometer  boundaries  are  chosen  with  string  BAROMETR, 
and  (e)  uniform  flux  boundaries  are  selected  with  string  UNIFLUX. 

119.  This  model  employs  a  staggered  grid  cell  system  where  water 
surface  levels,  x-direction  velocities,  and  y-direction  velocities  are  defined 
at  different  locations  on  a  cell.  These  positions  were  defined  in  Figure  4-4. 
Elevation  and  inverted  boundary  positions  are  referenced  relative  to  a  cell's 
center  and  river  discharge  and  uniform  flux  boundaries  are  specified  along 
cell  faces. 

120.  Boundary  grid  positions  are  defined  with  variables  BNP0S1,  BNP0S2, 
and  BNP0S3.  For  XBOUNDRY  records,  variable  BNP0S1  is  assigned  the  boundary's 
X- index,  whereas  variables  BNP0S2  and  BNP0S3  are  assigned  the  Y- indices  of  the 
starting  and  ending  cells,  respectively  (Figure  4-11).  For  YBOUNDRY  records, 
variable  BRP0S1  is  assigned  the  boundary's  Y-index,  and  variables  BRP0S2  and 
BRP0S3  are  assigned  the  X-indices  of  the  starting  and  ending  cells,  respec¬ 
tively.  Boundaries  can  be  identified  by  assigning  each  one  a  boundary  name 
with  variable  BNDNAM  on  the  XBOUNDRY  or  YBOUNDRY  records. 


Time-series  description  of  open  boundaries 

121.  Time -series  data  are  required  for  driving  the  flow  field  for  three 
of  the  boundary  options:  spatially  constant  elevation,  spatially  variable 
elevation,  and  spatially  constant  discharge  boundary  options.  XBOUNDRY  and 
YBOUNDRY  variable  BNDFN1  (for  all  three  options)  and  BNDFN2  (for  spatially 
variable  elevation  boundaries  only)  define  which  group  of  time-series  data  is 
to  be  used  to  drive  the  boundary  and  correspond  to  the  function  index  number 


Figure  4-11.  Definition  of  XBOUNDRY  and  YBOUNDRY 


assigned  to  variable  FUNNO  on  record  FUNCTION.  For  example,  an  application 
may  have  a  spatially  variable  elevation  boundary  and  two  spatially  constant 
elevation  boundaries  (Figure  4-12).  This  application  would  require  two 
FUNCTION  records  (one  at  each  end  of  the  spatially  variable  boundary)  to 
define  the  time  series  at  two  locations.  These  values  are  also  used  along  the 
spatially  constant  boundaries. 

122.  The  FUNCTION  record  is  required  for  time-series  data  and  defines 
the  character  of  the  forcing  function  driving  the  boundary.  Variable  FUNTYP 
on  record  FUNCTION  is  used  to  determine  if  the  boundary  is  forced  with 
harmonic  constituents  (HARMCNST) ,  tabular  elevation  data  (TABELEVS),  or 
tabular  discharge  data  (TABFLOWS) .  Variable  FUNITS  defines  the  units  used  for 
the  given  elevations  or  flows.  The  forcing  function  can  be  adjusted  by 
shifting  it  in  time  (phase  shift)  or  in  the  vertical  (datum  shift) ,  or  by 
multiplying  the  entire  time-series  by  an  adjustment  factor.  Variables  FSHIFT, 
FDATUM,  and  FMULT  on  record  FUNCTION,  respectively,  are  used  to  perform  these 
tasks.  The  forcing  function  can  be  gradually  spline-fit  from  initial  condi¬ 
tions  (usually  zero)  to  the  given  function  value  over  the  time  period  FEATHR 
defined  on  record  FUNCTION. 


Shoreline 


Harmonic  constituents 

123.  A  boundary  driven  with  harmonic  constituents  (FUNTYP  -  HARMCNST) 
requires  at  least  two  records  to  follow  the  FUNCTION  record:  one  CNRECORD 
record  and  at  least  one  CONSTIT  record.  First,  the  CNRECORD  record  specifies 
the  physical  coordinates  and  timing  associated  with  a  constituent  forcing 
function.  The  calendar  date  (variables  RYEAR,  RMONTH,  and  RDAY) ,  time  at  the 
start  of  the  simulation  (variable  RHOUR) ,  and  the  west  longitude  of  the  grid 
cell  where  the  forcing  function  is  applied  (RLONG)  are  specified  on  record 
CNRECORD.  Dates  and  times  can  be  referenced  to  Greenwich  Mean  Time  (GMT)  or 
local  time.  GMT  is  assumed  if  the  longitude  (RLONG)  equals  zero,  and  nonzero 
longitude  values  signal  a  local  time  specification.  CNRECORD  also  contains 
variable  RNAME  for  specifying  a  record  name  for  the  forcing  function. 

124.  One  CONSTIT  record  is  needed  for  each  constituent  used  in  generat¬ 
ing  the  time -series  data.  Variable  CNAME  on  record  CONSTIT  defines  which 
constituents  are  selected.  Table  4-5  provides  a  list  of  the  37  constituents 
available.  A  maximum  of  37  constituents  can  be  selected  (requiring  37  CONSTIT 
records)  and  are  referenced  with  the  naming  convention  developed  by  the 
National  Ocean  Survey  (NOS) .  Variable  CNAME  on  record  CONSTIT  is  used  to 
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select  any  of  the  constituents  listed  in  Table  4*5.  Other  data  entered  on 
this  record  include  the  constituents  amplitude  (CAMP)  and  epoch  (CEPOCH) . 
Tabular  elevation  time  series 

125.  Tabular  elevation  data  can  be  used  to  specify,  or  force,  a 
boundary.  WIFM  can  access  components  of  program  TIDEGEN  in  package  CMSUTIL 
(Appendix  B  of  the  CMS  User's  Manual)  to  internally  compute  the  tabular 
elevation  time-history  data  from  tidal  constituents.  Each  tabular  tide 
boundary  requires  a  TERECORD  to  precede  the  actually  water  surface  elevation 
data.  The  elevation  data  can  be  given  at  even  (constant)  time  increments 
(RR1NT  -  real  number)  or  at  user-specified  (irregular)  times  (RRINT  - 
IRREGINT) . 

126.  Constant  time  interval  data  are  entered  as  a  one -dimensional  array 
immediately  following  record  TERECORD.  The  time  interval  between  entries  is 
specified  with  variable  RRINT  (in  TUNITS)  on  record  TERECORD.  The  total 
number  of  tabular  elevation  data  entries  in  the  one -dimensional  array  is 
specified  with  variable  RENT.  The  user  must  also  specify  which  of  the  array 
elements  corresponds  to  the  start  of  the  simulation  with  variable  RSTART. 
Typically,  this  is  the  first  value  in  the  array.  However,  this  variable  must 
be  updated  for  hotstart  simulations.  Variable  RFORM  is  used  to  specify  the 
format  for  reading  the  one -dimensional  array,  and  variable  RNAME  is  used  for 
naming  the  tabular  tide  record. 

127.  For  the  irregularly  spaced  (in  time)  tabular  tide  data,  a  TERECORD 
and  a  series  of  TABELEV  records  are  required.  Variable  RRINT  on  record 
TERECORD  is  set  to  IRREGINT  for  irregularly  spaced  (in  time)  tide  data.  The 
remaining  variables  on  this  record  are  ignored  with  this  option. 

128.  One  TABELEV  record  is  needed  for  each  tabular  tide  entry.  The 
elevation  (FMAG  in  FUNITS)  and  time  of  occurrence  (FHR,  EMIN,  FSEC  in  hours, 
minutes  and  seconds)  are  required  on  each  TABELEV  record.  Elevations  are 
linearly  interpolated  at  those  time -steps  occurring  between  entries;  there¬ 
fore,  at  least  two  TABELEV  records  are  required.  The  first  TABELEV  record 
must  specify  the  elevation  at  or  before  the  start  of  the  simulation,  whereas 
the  last  TABELEV  record  must  specify  the  elevation  at  or  after  the  end  of  the 
simulation. 

Tabular  river  discharge  time  series 

129.  River  discharge  boundary  conditions  can  be  specified  at  any 
interior  grid  cell  face.  An  error  message  will  be  printed  and  execution 
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Table  4-5 


List  of  Available  Constituents 


NOS  Name 

_ Description _  1 

M2 

Semidiurnal 

S2 

Semidiurnal 

N2 

Semidiurnal 

K1 

Diurnal 

M4 

Shallow-water 

quarter  diurnal 

01 

Diurnal 

M6 

Shallow-water 

sixth  diurnal 

MK3 

Shallow-water 

terdiurnal 

S4 

Shallow-water 

quarter  diurnal 

MN4 

Shallow -water 

quarter  diurnal 

NU2 

Semidiurnal 

S6 

Shallow-water 

sixth  diurnal 

MU  2 

Semidiurnal 

2N2 

Semidiurnal 

001 

Diurnal 

LAMBDA2 

Semidiurnal 

SI 

Diurnal 

Ml 

Diurnal 

J1 

Diurnal 

MM 

Long  period 

SSA 

Long  period 

SA 

Long  period 

MSF 

Long  period 

MS 

Long  period 

RH01 

Diurnal 

01 

Diurnal 

T2 

Semidiurnal 

R2 

Semidiurnal 

2Q1 

Diurnal 

PI 

Diurnal 

2SM2 

Shallow-water 

semidiurnal 

M3 

Terdiurnal 

L2 

Semidiurnal 

2MK3 

Shallow-water 

terdiurnal 

K2 

Semidiurnal 

M8 

Shallow-water 

eighth  diurnal 

MS4 

Shallow-vncer 

quarter  diurnal 

terminated  if  this  boundary  condition  is  specified  at  an  outer -boundary  face. 
Furthermore,  depths  on  opposite  sides  of  the  river  boundary  cell  face  must  be 
less  than  zero,  signifying  a  water  cell.  Discharges  are  required  to  have 
units  of  flow  per  unit  width  (i.e., cubic  feet/second/foot  or  cubic 
meters/second/meter) . 
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130.  Each  river  discharge  boundary  function  requires  one  TFRECORD 
(analogous  to  the  tabular  tide  function  discussed  previously)  to  precede  the 
flow  data.  The  flow  data  can  be  given  at  even  (constant)  time  increments 
(RRINT  -  real  number)  or  at  user-specified  (irregular)  times  (RRINT  - 
IRREGINT) . 

131.  Constant  time  interval  data  are  entered  as  a  one -dimensional  array 
immediately  follow!  record  TFRECORD.  The  time  interval  between  entries  is 
specified  with  variable  RRINT  (in  TUNITS)  on  record  TFRECORD.  The  total 
number  of  tabular  flow  data  entries  in  the  one -dimensional  array  is  specified 
with  variable  RENT.  The  user  must  also  specify  which  of  the  array  elements 
corresponds  to  the  start  of  the  simulation  with  variable  RSTART.  Typically, 
this  is  the  first  value  in  the  array.  However,  this  variable  must  be  updated 
for  hotstart  simulations.  Variable  RFORM  is  used  to  specify  the  format  for 
reading  the  one -dimensional  array,  and  variable  RNAME  is  used  for  naming  the 
tabular  flow  record. 

132.  For  the  irregularly  spaced  (in  time)  tabular  flow  data,  a  TFRECORD 
and  a  eries  of  TABFLOW  records  are  required.  Variable  RRINT  on  record 
TFRECORD  is  set  to  IRREGINT  for  irregularly  spaced  (in  time)  flow  data.  The 
remaining  variables  on  this  record  are  ignored  with  this  option. 

133.  One  TABFLOW  record  is  needed  for  each  tabular  flow  entry.  The 
flow  rate  (FMAG  in  FUNITS)  and  time  of  occurrence  (FHR,  FMIN,  FSEC  in  hours, 
minutes,  and  seconds)  are  required  on  each  TABFLOW  record.  Flow  rates  are 
linearly  interpolated  at  those  time-steps  occurring  between  entries;  there¬ 
fore,  at  least  two  TABFLOW  records  are  required.  The  first  TABFLOW  record 
must  specify  the  flow  rate  at  or  before  the  start  of  the  simulation,  whereas 
the  last  TABFLOW  record  must  specify  the  flow  rate  at  or  after  the  end  of  the 
simulation. 

Inverted  barometer  boundary  condition 

134.  The  inverted  barometer  boundary  condition  can  be  selected  only  if 
model  SPH  (Chapter  3)  subprogram  is  used  to  generate  hurricane  wind  velocity 
and  atmospheric  pressure  fields  in  the  model.  With  the  inverted  barometer 
boundary  condition,  water  surface  elevations  are  computed  from  the  barometric 
pressure  anomaly.  As  the  barometric  pressure  decreases,  an  increase  in  water 
surface  level  occurs.  Conversely,  an  increase  in  barometric  pressure  forces 
the  water  surface  level  to  decrease. 
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135.  In  simulations  where  a  tidal  signal  is  specified  at  a  boundary  and 
hurricane  wind  fields  are  used,  WXFM  will  add  the  effects.  This  procedure  is 
valid  only  in  deep  water.  A  uniform  flux  boundary  condition  (UFBC)  should  be 
applied  in  the  nearshore  reach  of  adjacent  boundaries.  The  user  should  not 
include  an  XBOUNDRY  or  YBOUNDRY  record  for  an  inverted  barometric  boundary 
condition  in  the  above  case. 

Uniform  flux  boundary  condition 

136.  The  uniform  flux  boundary  condition  UFBC  is  similar  to  a  river 
discharge  boundary  condition  in  that  a  flux  is  applied  at  the  boundary  cell 
face.  However,  the  flux  through  the  cell  face  is  computed  internally  by  the 
computer  as  opposed  to  specifying  the  flux  for  a  river  boundary.  This 
boundary  condition  assumes  that  the  flux  through  the  boundary  cell  is  equal  to 
the  flux  through  the  opposing  cell  face. 

137.  Since  the  uniform  flux  boundary  condition  does  not  drive  a  flow 
field,  its  application  is  limited.  Therefore,  care  must  be  taken  in  applying 
a  UFBC.  Selecting  an  inappropriate  reach  (length)  of  the  boundary  may  lead  to 
erroneous  results.  The  user  should  test  the  sensitivity  of  choice  by  trying 
other  segment  lengths  which  band  the  chosen  reach. 

Wind-Field  Specifications 

138.  WIFM  can  simulate  hydrodynamics  influenced  by  either  hurricane  or 
uniform  (spatially  constant)  wind  fields.  However,  wind-field  calculations 
are  performed  only  if  record  WINDSPEC  and  related  records  reside  in  the  input 
data  deck.  Hurricane  wind  fields  are  computed  internally  in  WIFM  using 
components  of  the  SPH  wind-field  model.  Thus,  the  user  need  not  run  model  SPH 
to  create  wind- field  data  files  for  subsequent  processing  by  WIFM. 

139.  In  addition  to  record  WINDSPEC,  records  required  for  generating 
hurricane  wind  fields  include  SPHSPEC  and  TABSPH.  These  records  contain  the 
following  information  for  mathematically  describing  a  hurricane: 

a.  Peripheral  atmospheric  pressure. 

b.  Central  pressure  index. 

£.  Track  angle. 

d.  Radius  to  maximum  winds. 

e.  Maximum  wind  speed. 

f.  Angle  to  maximum  winds. 


g.  Wind  inflow  angle. 

h.  Latitude  and  longitude  of  storm's  eye. 

i.  Forward  speed  of  storm. 

The  user  is  referred  to  the  SPH  User's  Manual  (Chapter  3)  for  a  discussion  of 
input  data  requirements  for  records  SPHSPEC  and  TABSPH  and  guidance  for 
selecting  hurricane  parameters.  Hurricane  wind- field  input  data  requirements 
are  identical  for  WIFM  and  SPH. 

140.  Uniform  winds  are  selected  by  assigning  character  string  TABULAR 
to  variable  WTYPE  on  record  WINDSPEC.  Winds  may  be  steady  (constant)  or 
variable  in  time.  This  designation  is  made  with  variable  WNTRVL  set  to 
CONSTANT  or  VARIABLE,  respectively.  Steady  winds  require  one  TABWINDS  record, 
whereas  time-variable  winds  require  at  least  two  records. 

141.  For  the  time-variable  uniform  wind  option,  one  TABWINDS  record  is 
typically  entered  for  each  hour  of  the  simulation.  (More  frequent  data  occas- 
sionally  exists.)  The  model  will  then  linearly  interpolate  to  obtain  wind 
speed  and  direction  values  at  the  time  interval  specified  by  WINTRP  on  record 
WINDSPEC.  It  should  be  noted  that  WINTRP  must  be  assigned  a  value  that  is  an 
integer  multiple  of  the  time-step  DELT. 

142.  Variable  WUNITS  declares  the  system  of  unit"  for  wind  magnitudes. 
Valid  units  are  (a)  miles/hour  selected  with  chara.-  e*-  _r.ing  MPH, 

(b)  feet/second,  chosen  with  FPS ,  (c)  meters/second,  specified  with  MPS,  and 
(d)  knots,  selected  with  KNOTS.  Variable  PUNITS  declares  the  system  of  units 
for  atmospheric  pressure  data  and  is  applicable  for  hurricane  wind  fields 
only.  Data  can  have  units  of  millibars  (MILLIBAR),  feet  of  water  (FEETH20) , 
meters  of  water  (METERH20) ,  pounds  per  square  inch  (PSI),  inches  of  mercury 
(INCHESHG),  or  millimeters  of  mercury  (MMHG). 

143.  Strong  winds  that  are  instantaneously  applied  to  a  static  water 
basin,  such  as  at  the  start  of  a  simulation,  will  generate  extraneous  water 
oscillations  that  can  lead  to  the  model  becoming  unstable,  or  can  remain  in 
the  model  solution  for  a  significant  portion  of  a  simulation.  These  problems 
can  be  alleviated  by  gradually  increasing  wind  magnitudes  from  zero  at  the 
start  of  the  simulation,  to  the  actual  magnitude  several  hours  into  the 
simulation . 

144.  This  task  can  be  accomplished  either  by  the  user  adjusting  wind 
magnitudes  entered  on  the  TABWINDS  records  or  by  having  the  model  feather  the 
wind  speeds  internally.  With  feathering,  the  model  will  interpolate  wind 
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speeds  with  a  cubic  spline  function  until  that  time  specified  by  variable 
WFETHR  on  record  WINDSPEC.  This  function  assures  that  the  wind  speeds 
increase  smoothly.  Typical  values  assigned  to  variable  WFETHR  range  from  1  to 
3  hr. 

145.  Feathering  can  be  applied  to  both  uniform  and  hurricane  wind 
fields,  and  also  to  their  related  constant  and  time-variable  options.  Because 
hotstart  simulations  are  continuations  of  previous  runs,  feathering  should  not 
be  performed  for  these  types  of  simulations. 

146.  All  TABWINDS  records  must  immediately  follow  the  WINDSPEC  record. 
Furthermore,  times  entered  on  these  records  must  correspond  to  the 
simulation's  starting  time  defined  by  variable  TPROV  on  record  TIMESPEC.  For 
the  constant  and  time-variable  options,  the  first  TABWINDS  record  must  occur 
no  later  than  the  start  of  the  simulation.  For  the  time-variable  option,  the 
last  TABWINDS  record  must  occur  no  earlier  than  the  end  of  the  simulation. 

147.  For  example,  if  the  simulation  begins  at  0  hr  0  min  and  has  a 
duration  of  36  hr,  the  first  TABWINDS  record  must  specify  wind  conditions 
occurring  at  (or  before)  0  hr  0  min,  and  the  last  record  must  occur  at  36  hr  0 
min  (or  later).  Should  the  simulation  be  continued  with  the  hotstart  option, 
all  times  entered  on  the  TABWINDS  record  are  referenced  to  the  original 
starting  time.  Assuming  the  hotstart  begins  at  hour  36  and  has  a  duration  of 
24  hr,  the  first  TABWINDS  record  must  have  as  its  time  no  later  than  36  hr  0 
min.  The  last  TABWINDS  record  must  have  as  i.s  time  60  hr  0  min  (or  later). 

148.  WIFM  uses  the  meteorological  convention  in  defining  wind  direc¬ 
tion:  zero-deg  angle  defines  a  wind  blowing  from  north  to  south,  and  the 

angles  increase  in  value  in  the  clockwise  direction.  For  example,  a  wind 
blowing  from  east  to  west  has  an  angle  of  90  deg.  Wind  angles  should  not  be 
corrected  to  account  for  the  grid  rotation  relative  to  geographic  direction. 
The  model  performs  this  task  internally. 

Output  Specification 

149.  WIFM  provides  several  options  for  displaying  output,  including: 

(a)  numerical  gage  time-histories  at  selected  grid  cells  (elevations,  wind, 
and/or  water  velocities),  (b)  wind  or  water  velocity  vector  fields  at  user- 
specified  times  during  a  simulation,  and  (c)  an  output  listing  containing  an 
input  data  summary  and  a  printout  of  field  arrays.  These  data  files  can  be 
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used  as  input  to  hydrodynamic  models  as  well  as  wave  hindcast  models .  Data 
can  be  displayed  in  either  tabular  or  graphical  form  with  the  postprocessing 
package  CMSPOST  discussed  in  Appendix  D  of  the  CMS  User's  Manual. 

150.  The  output  listing  containing  a  summary  of  the  input  data  set  is 
generated  for  every  simulation.  Error  and  warning  diagnostic  messages  are 
also  contained  in  this  listing.  A  sample  output  listing  containing  a  summary 
of  the  input  data  set  is  presented  in  Figure  4-13. 

151.  Each  record  is  summarized  in  tabular  form  with  a  heading  contain¬ 
ing  its  record  identification  label  followed  by  a  brief  description  of  that 
record's  function.  A  table  is  composed  of  each  variable's  name,  a  description 
of  that  variable  (including  its  units,  when  applicable),  and  an  error  diagnos¬ 
tic  note. 

152.  WIFM  contains  error  diagnostic  features  that  inspect  an  input  data 
set  for  possible  errors.  These  features  include:  (a)  comparing  an  inputted 
value  against  a  range  of  quantities  that  are  representative  for  that  variable, 
(b)  checking  for  misspelled  character  data,  and  (c)  checking  for  missing  data. 
The  error  diagnostic  note  can  be  assigned  one  of  three  character  strings, 
which  are:  (a)  "FATAL"  for  errors  where  the  model  cannot  execute  given  the 
value  supplied,  (b)  "WARN"  for  data  that  are  outside  the  range  of  values 
typically  selected  for  that  variable,  and  (c)  a  null  string  for  instances 
where  an  error  condition  has  not  been  identified.  Although  this  model 
contains  error  diagnostic  capabilities,  the  user  should  thoroughly  inspect  the 
input  data  summary  to  ensure  that  the  data  are  correct . 

153.  Field  arrays  (e.g.,  free  surface  elevations,  water  velocities, 
wind  velocities,  bathymetry,  atmospheric  pressure)  are  printed  along  with  the 
input  data  summary  by  including  one  or  more  PRWINDOW  records.  Variable  WPRVAR 
on  record  PRWINDOW  is  used  to  specify  which  field  arrays  are  to  be  printed 
(e.g.,  WPRVAR  -  E  for  water  surface  elevations).  The  user  can  control 
printing  of  field  arrays  through  the  course  of  a  simulation  by  specifying  the 
starting  (WPRSTR)  and  ending  (WPREND)  times,  together  with  the  time  interval 
(WPRINT) ,  at  which  the  data  will  be  printed.  Furthermore,  the  user  can 
specify  printing  of  subgrid  regions  as  opposed  to  the  entire  grid.  This  is 
done  by  specifying  the  x-  and  y-boundaries  of  a  subgrid  region  with  variables 
WXCEL1 ,  WXCEL2 ,  WYCEL1 ,  and  WYCEL2 . 

154.  Gage  time -histories  of  field  arrays  are  saved  with  record  RECGAGE. 
One  RECGAGE  record  is  required  for  each  desired  output  location  where  the  free 
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surface  elevation,  wind  and  water  velocity,  and  atmospheric  pressure  fields 
are  to  be  saved.  A  maximum  of  120  gages,  each  containing  up  to  1,000  points, 
can  be  processed.  All  gage  time -histories  are  stored  in  one  file  and  are 
processed  by  programs  HYDADD,  HYDLST,  and  HYDPLT  in  package  CMSPOST. 

155.  Variables  GXPOS  and  GYPOS  on  record  RECGAGE  define  the  grid 
location  where  field  arrays  are  saved.  The  time  interval  at  which  these  data 
are  stored  is  controlled  by  variable  DTGAGS  on  record  TIMESPEC.  Variable 
GTYPE  on  record  RECGAGE  is  applicable  only  to  averaging  water  velocities 
generated  by  model  WIFM  and  does  not  affect  output  from  model  SPH. 

156.  Record  RECSNAPS  allows  the  user  to  store  wind  and  water  velocity 
data  for  generating  vector  plots.  The  stored  data  can  also  be  used  as  input 
to  other  models.  Data  can  be  saved  at  regular  time  intervals  (SNPTYP  - 
INTERVAL),  at  specific  times  during  a  simulation  (SNPTYP  -  TIMES),  or  both; 
however,  all  time  indices  must  be  integer  multiples  of  the  tine -step  DELT. 

For  data  storage  at  regular  time  intervals,  SNPSTR  defines  the  time  at  which 
data  storage  is  to  begin,  SNPEND  defines  the  time  at  which  data  storage  is  to 
end,  and  SNPINT  is  the  regular  time  interval  at  which  data  storage  occurs. 

For  data  storage  at  user- specified  times,  one  RECSNAPS  record  is  required  for 
each  time  (SNPTIM)  at  which  a  snapshot  is  to  be  recorded.  All  times  on  record 
RECSNAPS  are  in  TUNITS.  More  than  one  RECSNAPS  record  can  be  used,  and  up  to 
100  snapshots  can  be  saved  in  a  file.  These  data  can  be  processed  with 
programs  SNAPC0N,  SNAPLST,  and  SNAPVEC  which  reside  in  package  CMSPOST. 

157.  Records  XRECRANG  and  YRECRANG  allow  the  user  to  save  data  describ¬ 
ing  discharges  across  arbitrary  transects.  These  data  allow  the  user  to 

(a)  check  flow  through  various  tributaries  or  (b)  determine  the  tidal  prism. 
One  record  is  required  for  each  desired  output  location.  A  maximum  of 
120  ranges,  each  containing  up  to  1,000  points,  can  be  processed.  All  range 
time-histories  are  stored  in  one  file  and  are  processed  by  programs  HYDADD, 
HYDLST,  and  HYDPLT  in  package  CMSPOST. 

158.  Similar  to  barriers  and  boundaries,  variable  RP0S1  defines  the  x- 
cell  position  (for  XRECRANG)  or  the  y-cell  position  where  data  ere  to  be 
recorded.  Variables  RP0S2  and  RP0S3  define  the  range,  or  extent,  of  the 
recording  range  location.  For  XRECRANG,  records  RP0S2  and  RP0S3  indicate  the 
y-extent,  and  for  YRECRANG  records  RP0S2  and  RP0S3  indicate  the  x-extent.  The 
time  interval  at  which  these  data  are  stored  is  controlled  by  variable  DTGAGS 
on  record  TJMESPEC.  RNAME  is  used  to  name  the  range  data. 
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PART  V:  ILLUSTRATIVE  EXAMPLES 


159.  Five  Illustrative  examples  are  included  in  this  section  to  demon¬ 
strate  WIFM's  capabilities.  The  grid  geometry  for  the  first  four  examples  is 
the  same;  however,  the  forcing  functions  vary.  The  75  by  30  cell  study  area 
used  in  the  first  four  examples  consists  of  an  open  ocean  and  back-bay  area 
joined  through  an  inlet  and  two  barrier  islands  (Figure  4-14).  Boat  traffic 
through  the  inlet  is  protected  with  two  jetties.  A  small  island  situated  in. 
the  back  bay  is  also  simulated.  The  examples  include  (a)  a  tidal  forcing 
simulation  without  advection  and  diffusion  terms  or  feathering,  (b)  a  tidal 
forcing  simulation  starting  at  slack  water  and  with  nonlinear  terms,  (c)  a 
wind- induced  setup  simulation,  and  (d)  a  river  discharge  s  -milation.  Although 
the  examples  show  individual  applications  of  wind  and  discharge  forcing 
functions,  they  can  be  combined  and  applied  simultaneously.  The  fifth  example 
simulates  a  hurricane  in  the  Gulf  of  Mexico  and  the  associated  storm  surge 
that  would  inundate  the  coastal  United  States.  This  example  combines  the 
effects  of  winds  and  tides . 
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Figure  4-14.  Computational  grid  for  four  examples 


160.  The  tidal  forcing  simulation  was  run  on  the  75  by  30  cell  grid 
described  previously  (Figure  4-15).  The  grid's  spatial  resolution  was  500  ft 
in  the  on-offshore  (x-)  direction  and  1,000  ft  in  the  longshore  (y-)  direction 
for  an  overall  grid  size  of  37,500  by  30,000  ft.  It  should  be  noted  that  the 
grid  resolution  between  jetties  is  usually  much  finer  (more  cells)  than  what 
is  used  in  these  examples,  in  order  to  properly  represent  inlet  hydrodynamics. 
The  water  depth  in  the  back  bay  was  held  to  a  constant  depth  of  10  ft.  The 
water  depth  varied  from  30  ft  along  the  shoreline  cells  to  300  ft  at  the 
offshore  boundary.  The  duration  of  the  simulation  was  24  hr. 

161.  A  tidal  forcing  function  was  implemented  along  the  offshore 
boundary  (Tl)  using  harmonic  constituent  data  (M2  tide,  amplitude  -  3.97  ft, 
epoch  -  199.02).  Elevation  values  were  spatially  constant  along  the  seaward 
boundary.  Thus,  all  the  seaward  boundary  cells  acted  as  one  entity,  having 
the  same  time-series  of  water  surface  fluctuations.  The  tidal  forcing 
function  at  the  shoreline  (T2)  was  identical  to  the  offshore  tidal  forcing 
function,  except  for  a  10-min  phase  lag.  Elevation  values  along  the 
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Figure  4-15.  Computational  area  for  tidal 
forcing  simulations 
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lateral  boundary  cells  were  interpolated  from  the  two  forcing  functions  (T1 
and  T2)  applied  at  the  ends  of  the  boundary  segment.  Tide  gages  were  placed 
at,  two  locations,  in  the  inlet  (cell  (19,16))  and  in  the  open  ocean 
(cell  (42,15)),  to  monitor  hydrograph  data. 

162.  The  input  data  set  is  given  in  Table  4-6  and  is  discussed  below. 
The  location  and  type  of  boundary  forcing  functions  are  specified  with 
XBOUNDRY  and  YBOUNDRY  records.  FUNCTION,  CNRECORD ,  and  CONSTIT  records  give 
specifics  about  the  two  tidal  forcing  functions,  such  as  the  harmonic  constit¬ 
uent^)  used,  amplitude(s) ,  epoch(s),  and  time(s)  of  occurrence.  XBARRIER  and 
YBARRIER  records  were  used  to  denote  the  two  jetties.  Record  BATHSPEC  is  used 
to  describe  the  bathymetric  data,  and  RECGAGE  records  show  the  locations  of 
the  two  recording  gages.  The  PRWINDOW  record  was  used  to  print  elevations  and 
velocities  for  the  entire  grid  to  the  output  summary  file  at  1-hr  time 
intervals  (Table  4-7). 

163.  The  simulation  was  run  for  86,400  sec  (24  hr),  and  elevation  and 
velocity  values  were  saved  every  360  sec  at  the  two  recording  gage  locations. 
At  the  conclusion  of  the  simulation,  the  hydrograph  data  were  examined  to 
check  model  results  (Figures  4-16  and  4-17).  The  water  surface  elevation  at 
the  inlet  gage  shows  a  slight  spurious  oscillation  at  the  start  of  the 
simulation,  but  the  oscillation  diminishes  within  one  tidal  cycle.  This 
slight  "start-up"  error  can  be  virtually  eliminated  by  applying  the  tidal 
forcing  function  more  gradually  (feathering)  or  by  starting  the  simulation  at 
slack  water.  (See  variable  FEATHR  on  the  FUNCTION  record  or  variable  SELEV  on 
record  STARTUP.) 

164.  The  water  surface  elevations  at  the  open  ocean  gage  oscillate  with 
a  very  slight  start-up  error  as  previously  described.  The  velocities  at  the 
open  ocean  gage  travel  in  the  x  (90  deg)  and  -x  (-90  deg)  directions  with  a 
magnitude  of  approximately  1.3  ft/sec.  The  direction  is  dictated  by  the  fact 
that  the  forcing  function  at  the  offshore  boundary  is  spatially  constant,  and 
the  bathymetric  contours  are  straight  and  parallel  to  the  shoreline.  The 
velocities  through  the  inlet  travel  diagonally  across  the  grid  (45  and 

-135  deg)  as  directed  by  the  jetties.  The  peak  magnitude  is  approximately 
2.5  ft/sec. 

165.  In  summary,  an  M2  tide  was  simulated  in  a  typical  study  environ¬ 
ment  to  show  WIFM's  ability  to  predict  water  surface  fluctuations  and  veloci¬ 
ties  in  response  to  the  forcing  function. 
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Table  4-6 


Input  Data  Set  for  the  Tidal  Forcing  Simulation 


GENSPECS 

WIFM  SIMULATION  NO. 

.  1:  TIDE 

I  WITHOUT  FEATHERING 

ENGLISH 

TIMESPEC 

30. 

SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGLISH 

75 

30 

500. 

1000. 

0. 

0. 

.0 

0. 

PRWINDOW 

3600. 

EV 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1 

BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1 

BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

17 

14 

14 

2.5 

XB1 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

XBARRIER 

20 

18 

18 

2.5 

XB5 

YBARRIER 

13 

17 

17 

2.5 

YB1 

YBARRIER 

14 

18 

19 

2.5 

YB2 

YBARRIER 

15 

20 

21 

2.5 

YB3 

YBARRIER 

16 

22 

23 

2.5 

YB4 

YBARRIER 

16 

17 

18 

2.5 

YB5 

YBARRIER 

17 

19 

20 

2.5 

YB6 

YBARRIER 

18 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(6X.9F8.1) 

1 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

2 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

10.0 

-10.0 

-10.0 

-10.0 

-10.0 

99.0 

99.0 

99.0 

3 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

10.0 

-10.0 

-10.0 

-10.0 

-10.0 
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Table  4-7 


Output  Summary  for  the  Tidal  Forcing  Simulation 


COASTAL  MODELING  SYSTEM  (CMS):  WIFM2D.  VERSION  1.0 

-  W1FM  SIMULATION  NO.  1:  TIDE  WITHOUT  FEATHERING 


GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

•  -  -  —  -  “  ■  ■ 

• 

•*•••  GRIDSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

GRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

•  GUNITS 

SYSTEM  OF  WITS  USED  FOR  THE  GRID 

ENGLISH 

XCELL 

NUWER  OF  GRID  CELLS.  X  DIRECTION 

75 

*  YCELL 

NUMBER  OF  GRID  CELLS.  Y  DIRECTIW 

30 

DX 

SPATIAL  STEPSIZE  IN  X  DIRECTION 

500.00 

•  DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTIW 

1000.00 

GLAH 

LATITUDE  OF  GRID  QRI6IN  (DEGREES) 

0.00 

•  aONG 

LONGITUDE  OF  GRID  ORIGIN  (DEGREES) 

0.00 

SALIGN 

GRID  ROTATION  FDR  EAST  (DEGREES) 

0.00 

• 

*****  TITCSPEC  CARD:  SPECIFICATION  OF  COMPUTATIONAL  TI*  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

•  VARIABLE 

DESCRIPTIW  OF  USAGE: 

VALUE: 

DELT 

COrUTATItML  TIME  STEP  (SECONDS) 

30.0 

•  TWITS 

TIME  UNITS  FOR  All  DTUT  VARIABLES 

BECOME 

TPROV 

TIK  AT  START  OF  MODEL  SIMULATION 

0.0 

•  WAX 

TOTAL  TIME  OF  SIMULATION 

86400.0 

DTGAfiS 

TIME  INTERVAL  TO  SAVE  GAGE  DATA 

360.00 

•  OTHOTS 

TIIC  INTERVAL  TO  SANE  HOTSTARTS 

86400.00 

COASTAL  MODELING  SYSTEM  (CHS):  WIFH2D.  VERSION  1.0 


HYDROGRAPH  AND  VELOCITY  fEASURBENTS:  2  GAGES 


GAGE  GAGE-POSITION  VELOCITY-ftASUREHEXT 
NUMBER:  X  Y  NOTES:  TYPE:  NOTES:  GAGE  NAfC: 


1  19  16  UAV6UAUG 

2  42  IS  UAVGVASC 


INLET  SAGE 
OCEAN  GAGE 


*****  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA 

♦ 

STARTIN6 

ENDING 

STARTING 

ENDING 

f 

T1KS  TO  PRINT 

(SEDOTCS  ):  • 

VARIABLE 

Fiau 

NUMBER  » 

X  CELL 

X  CELL 

Y  CELL 

Y  CELL  NOTES: 

•  START  AT 

EM)  AT 

INTERVAL  NOTES:  * 

ARRAYS  TO 

PRINT: 

1 

• 

X=  1 

X=  75 

Y=  1 

Y=  30 

• 

0.0 

86400.0 

3600.0  * 

EV 

NOTES: 


NOTES: 


NOTES: 


NOTES: 
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Figure  4-17.  Velocity  plots  for  the  tidal  forcing  simulation 


Tidal  Forcing  Simulation  with  Nonlinear  Terms 

166.  The  tidal  forcing  simulation  was  repeated  with  the  addition  of 
records  ADDTERMS  and  STARTUP.  Record  ADDTERMS  is  used  to  include  advective 
and  diffusion  terms  in  the  governing  equations.  The  nonlinear  terms  are  more 
difficult  and  time-consuming  to  simulate,  but  provide  a  more  realistic 
representation  of  the  hydrodynamics  in  the  study  area,  particularly  at  the 
inlet  where  velocity  gradients  are  greatest.  Record  STARTUP  is  used  to  raise 
the  entire  water  surface  to  the  peak  flood  elevation.  At  peak  flood  (or  ebb), 
velocities  reach  zero,  and  the  initial  and  boundary  conditions  are  consistent. 
The  "start-up"  error  observed  in  the  last  example  can  be  reduced  considerably 
with  this  procedure.  Table  4-8  shows  the  addition  of  records  ADDTERMS  and 
STARTUP  to  the  input  data  set.  In  addition,  record  PRWINDOW  was  modified  to 
print  elevations  to  the  output  file  at  the  conclusion  of  the  simulation  only 
(Table  4-9). 

167.  The  elevation  and  velocity  hydrographs  at  ♦’he  inlet  and  open  ocean 
gages  are  presented  in  Figure-.  4-18  ana  4-19.  The  elevations  do  not  exhibit 
the  degree  of  spurious  oscillation  observed  in  the  first  example.  Starting 
the  simulation  at  slack  water  considerably  reduced  the  start-up  error.  The 
velocities  also  appear  Co  be  different  than  the  velocities  in  the  first 
example.  The  magnitude  of  the  velocity  at  the  open  ocean  gage  is  no  longer 
equal  on  the  ebb  and  flow  due  to  the  nonlinear  terms.  The  direction  of  the 
velocity  vectors  at  the  open  ocean  gage  are  no  longer  in  the  +x  and  -x- 
directions,  but  rather,  have  a  slight  y-direction  component  due  to  the 
nonlinear  terms. 

Wind- Induced  Setup  Simulatirn 

168.  In  the  third  test  si.  lation,  a  uniform  v*nd  was  blown  In  the 
shoreward  direction  for  the  duration  of  the  simulation  (Figure  4-20).  (The 
tidal  forcing  functions  from  the  first  simulation  were  also  included.)  The 
wind  gradually  increased  over  the  first  hour,  until  a  maximum  sustained  wind 
speed  of  40  knots  was  reached  (Figure  4-21).  Table  4-10  shows  the  addition  of 
the  WINDSPEC  and  TABWINDS  records  to  the  input  data  set  to  specify  the 
gradually  applied  wind  field.  These  records  are  use^’  to  describe  the 
magnitude  and  direction  of  the  wind  field  at  designated  times  during  the 
simulation.  The  PRWINDOW  record  was  used  to  print  elevations  at  hours  12  and 
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Table  4-8 

Input  Data  Set  for  the  Tidal  Forcing  Simulation  with  Nonlinear  Terms 


GENSPECS  WIFM  SIMULATION  NO.  2:  TIDE  WITH  NONLINEAR  TERMS  ENGLISH 


TIMESPEC 

30. 

SECONDS 

0. 

75600. 

360. 

STARTUP 

4.048 

GRIDS PEC 

ENGLISH 

75 

30 

500. 

1000. 

0. 

0.0 

0. 

PRWINDOW 

3600. 

EV 

ADDTERMS 

NONCONSCONSTDIF 

5. 

0. 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1 

BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1 

BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

5.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

5.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

17 

14 

14 

2.5 

XB1 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

XBARRIER 

20 

18 

18 

2.5 

XB5 

YBARRIER 

13 

17 

17 

2.5 

YBl 

YBARRIER 

14 

18 

19 

2.5 

YB2 

YBARRIER 

15 

20 

21 

2.5 

YB3 

YBARRIER 

16 

22 

23 

2.5 

YB4 

YBARRIER 

16 

17 

18 

2.5 

YB5 

YBARRIER 

17 

19 

20 

2.5 

YB6 

YBARRIER 

18 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(6X.9F8.1) 

1 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

S3.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

2 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

99.0 

99.0 

99.0 

3 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

-10.0 

99.0 

99.0 
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Table  4-9 


Output  Summary  for  the  Tidal  Forcing  Simulation  with  Nonlinear  Terms 


COASTAL  MODELING  SYSTEM  ICMS):  N  1  F  fl  2  0  •  VERSION  1.0 

-  WIFM  SIMULATION  NO.  2:  TIDE  WITH  NCH.INEAR  TERMS 


•»♦*♦  6ENSFECS  CARO:  SPECIFICATION  OF  TITLE  AND  6ENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

SUNIT5 

UNITS  SYSTEM  USED  IN  CONFUTATIONS 

ENGLISH 

* 

•»*♦*  GRIDSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

value: 

notes: 

GRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

•  GUNITS 

SYSTEM  OF  UNITS  USED  FOR  THE  GRID 

ENGLISH 

XCEH 

NUMBER  OF  GRID  CELLS.  X  DIRECTION 

75 

•  YCELL 

NUMBER  OF  GRID  CELLS.  Y  DIRECTION 

30 

DX 

SPATIM.  STEPSIZE  IN  X  DIRECTION 

500.00 

•  DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTION 

1000.00 

GLATT 

LATITUDE  OF  GRID  ORIGIN  (DEGREES) 

0.00 

*  GLONS 

LONGITUDE  OF  GRID  0RI6IN  (DEEREES) 

0.00 

GALIGN 

GRID  ROTATION  FOR  EAST  (DEGREES) 

0.00 

• 

«««*«  TIIESPEC  CARD:  SPECIFICATION  OF  COVUTATIONAL  TIME  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

«  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

oaT 

COfUTATIOML  THE  STEP  (SEEWDS) 

30.0 

•  TWITS 

THE  UNITS  FOR  AU.  IfflJT  VARIABLES 

secocs 

TPROV 

THE  AT  START  OF  MODEL  SIMULATION 

0.0 

« mu 

TOTAL  THE  OF  SIMULATION 

86400.0 

DT6AGS 

THE  INTERVAL  TO  SAVE  GAGE  DATA 

360.00 

«  DDCTS 

THE  INTERVAL  TO  SAVE  HOTSTARTS 

86400.00 

COASTAL  MODELING  SYS 

TEH  ( 

CHS) 

:  U  I  F  M 

2D.  VERSION  1.0 

*****  HYDROGRAPH  AND  VELOCITY  TEASURENENIS:  2  GASES 


GAGE  GAGE -POSITION  VELOCITY-TEASUREIENT 

NUMBER:  X  Y  NOYES:  TYPE:  NOTES:  GAGE  NAK: 


1  19  16  UAVGVAVG 

2  42  IS  UAVGVAVG 


ltt-ET  GAGE 
OCEAN  GAGE 


*****  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA 

* 

starting 

ENDING 

STARTING 

ENDING 

»  TIIES  TO  PRINT 

(SECONDS  >:  • 

VARIABLE  FIELD 

HUBER 

* 

t 

X  CELL 

X  CELL 

Y  CELL 

YCELL  NOTES: 

•  START  AT  EM)  AT 

INTERVAL  NOTES:  • 

ARRAYS  TO  PRINT:  NOTES: 

1 

1 

X*  1 

X*  73 

Y*  1 

Y=  30 

•  0.0  86400.0 

43200.0  • 

E 
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24  of  the  simulation  (Table  4-11).  The  inlet  and  ocean  hydrographs  are 
presented  in  Figures  4-22  and  4-23  and  are  discussed  in  the  following. 

169.  As  the  simulation  proceeds,  the  wind  continues  to  blow  shoreward 
causing  a  setup  to  develop.  From  Figure  4-22  it  appears  that  the  elevations 
are  the  same  for  the  tide  with  wind  as  with  the  tide  alone.  However,  there  is 
a  slight  rise  in  the  mean  water  surface  elevation.  The  magnitude  of  the 
velocities  at  the  open  ocean  gage  show  a  larger  peak  ebb  value  than  peak  flood 
value.  This  is  caused  by  the  tide  flow  and  the  free  surface  gradient  created 
by  the  onshore  wind  being  in  the  same  or  opposite  directions,  respectively. 
(The  water  surface  slope  created  by  the  onshore  wind  works  against  the  onshore 
propagation  of  the  tide  wave.) 


X 

9  Tidal  Forcing  Function 
■  Recording  Gog*  Location 


Figure  4-20.  Computational  grid  for  wind- induced 
setup  simulation 


dOH  9  US 


Figure  4-21.  Wind  magnitude  and  directions  for  wind-induced  setup  simulation 


Table  4-10 

Input  Data  Set  for  the  Wind- Induced  Setup  Simulation 


GENSPECS 

WIFM  SIMULATION  NO, 

,  3: 

TIDE  WITH  WIND 

ENGLISH 

TIMESPEC 

30. 

SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGLISH 

75 

30 

500. 

1000.  0. 

0.0  0. 

PRWINDOW 

43200. 

E 

WINDSPEC 

TABULARVARIABLE 

KNOTS 

PSI 

TABWINDS 

0. 

0.0 

0.0 

90. 

TABWINDS 

0. 

6.0 

1.0 

90. 

TABWINDS 

0. 

10.0 

2.0 

90. 

TABWINDS 

0. 

16.0 

4.0 

90. 

TABWINDS 

0. 

20.0 

6.0 

90. 

TABWINDS 

0. 

26.0 

10.0 

90. 

TABWINDS 

0. 

42.0 

24.0 

90. 

TABWINDS 

0. 

50.0 

31.0 

90. 

TABWINDS 

0. 

54.0 

34.0 

90. 

TABWINDS 

0. 

58.0 

36.4 

90. 

TABWINDS 

1. 

2.0 

38.4 

90. 

TABWINDS 

1. 

6.0 

39.4 

90. 

TABWINDS 

1. 

8.0 

40.0 

90. 

TABWINDS 

24. 

0.0 

40.0 

90. 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

20 

10 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1  BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1  BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1  2. 

6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

17 

14 

14 

2.5 

XB1 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

XBARRIER 

20 

18 

18 

2.5 

XB5 

YBARRIER 

13 

17 

17 

2.5 

YB1 

YBARRIER 

14 

18 

19 

2.5 

YB2 

YBARRIER 

15 

20 

21 

2.5 

YB3 

YBARRIER 

16 

22 

23 

2.5 

YB4 

YBARRIER 

16 

17 

18 

2.5 

YB5 

YBARRIER 

17 

19 

20 

2.5 

YB6 

YBARRIER 

18 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(6X.9F8.1) 

1 

99.0 

99.0 

99.0 

99, 

.0  99 

.0 

99.0  99.0 

99.0  99.0 
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Table  4-11 


Output  Summary  for  the  Wind- Induced  Setup  Simulation 


COASTAL  MODELING  SYSTEM  (CMS):  M  1  F  M  2  D  .  VERSION  1.0 


W1FM  SIMULATION  NO.  3:  TIDE  WITH  WIND 


*****  8ENSPECS  CWffl:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE! 

VALUE! 

notes: 

•  VARIABLE 

DESCRIPTION  OF  USAGE.* 

VALUE: 

notes: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

* 

*****  SRIDSPEC  CARD:  SPECIFICATION  OF  T)E  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

6RTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

•  GUNITS 

SYSTEM  OF  UNITS  USED  FOR  TIC  GRID 

ENGLISH 

I  CELL 

NUMBER  OF  GRID  CELLS.  X  DIRECTION 

75 

•  YCELL 

NUMBER  OF  GRID  CELLS.  Y  DIRECTION 

30 

DX 

SPATIAL  STEPSIZE  IN  X  DIRECTION 

500.00 

•  DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTION 

1000.00 

GLATT 

LATITUDE  OF  GRID  ORIGIN  (DEGREES) 

0.00 

*  GL0N6 

LONGITUDE  OF  GRID  0R161N  (DEGREES) 

0.00 

GALIGN 

GRID  ROTATION  FUR  EAST  (DEGREES) 

0.00 

* 

«««««  TIHESPEC  CARD:  SPECIFICATION  OF  COMPUTATIONAL  THE  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE; 

NOTES: 

•  VARIABLE 

* 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

BELT 

COMPUTATIONAL  Tilt  STEP  (SECONDS) 

30.0 

•  TUNITS 

TIME  UNITS  FOR  ALL  INPUT  VARIABLES 

SECONDS 

TPROV 

TI*  AT  START  OF  MODEL  SIMULATION 

0.0 

*  TMAX 

TOTAL  THC  OF  SIMULATION 

86400.0 

DTBA6S 

THE  INTERVAL  TO  SAVE  GAGE  DATA 

360.00 

*  0TH0TS 

TIME  INTERVAL  TO  SAVE  HOTSTARTS 

86400.00 

COASTAL  MODELING  SYSTEM  (CMS):  NIFM2D.  VERSION  1.0 


**•»•  HYDROGRAPH  AND  VELOCITY  MEASUREMENTS:  2  GAGES 


GAGE  GAGE-POSITION  VELOCITY -fCASURDCNT 

NUMBER:  X  Y  NOTES:  TYPE:  NOTES.*  GAGE  NAPE: 


1  IV  16  UAVGVAV6 

2  42  15  UAVGWV6 


INLET  GAGE 
OCEAN  SAGE 


*****  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA 

• 

STARTIN6 

ENDING 

STARTING 

ENDING 

$ 

TINES  TO  PRINT  (SECOMXS  ): 

t 

VARIABLE  FIELD 

NUMBER  • 

a 

X  CELL 

X  CELL 

Y  CELL 

YCEll  NOTES: 

•  START  AT 

Eft  AT 

INTERVAL  NOTES: 

$ 

ARRAYS  TO  PRINT:  NOTES: 

1 

$ 

X=  1 

X=  75 

Y*  1 

Y*  30 

w  — 

• 

0,0 

86400.0 

43200.0 

•  • 

• 

E 
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gure  4-22.  Elevation  plots  for  the  wind- induced  setup  simulation 


Figure  4-23.  Velocity  plots  for  the  wind- induced  setup  simulation 


River  Discharge  Simulation 


■*70.  In  the  fourth  simulation,  a  river  flowing  into  the  back-bay  area 
at  a  rate  o*-  .,250  ft3/sec  was  simulated  (Figure  4-24).  (The  tidal  forcing 
functions  from  the  first  simulation  were  also  included.)  The  river  inflow 
gradually  increased  over  the  first  hour,  until  a  maximum  sustained  flow  rate 
of  1,250  ft3/sec  was  reached.  Table  4-12  shows  the  addition  of  a  FUNCTION, 
TFRECORD,  and  several  TABFLOW  records  to  the  input  data  set  to  specify  the 
tabular  flow  forcing  function.  These  records  are  used  to  specify  inflow 
velocities  at  designated  times  during  the  simulation.  An  additional  RECGAGE 
record  was  placed  near  the  river  mouth  for  monitoring  purposes.  The  PRWINDOW 
record  was  used  to  print  elevations  at  hours  12  and  24  for  the  simulation 
(Table  4-13).  The  inlet,  ocean,  and  river  hydrographs  are  presented  in 
Figures  4-25  through  4-27  and  are  discussed  below. 

171.  From  Figure  4-25  it  appears  that  the  elevations  at  all  three  gages 
are  dominated  by  the  tidal  forcing  functions.  The  velocities  at  the  open 
ocean  and  inlet  gages  are  dominated  by  the  tidal  forcing  (Figure  4-26); 
however,  the  river  gage  shows  little  effect  of  the  tidal  forcing  function 
(Figure  4-27).  Velocities  are  dominated  by  the  river  inflow. 


n  n 


Figure  4-24.  Computational  grid  for 
the  river  discharge  simulation 
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Table  4-12 


Input  Data  Set  for  the  River  Discharge  Simulation 


GENSPECS  WIFM  SIMULATION  NO.  4:  TIDE  WITH  RIVER  DISCHARGE 


TIMESPEC 

30. 

SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGLISH 

75 

30 

500. 

1000.  0. 

PRWINDOW 

43200. 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

RECGAGE 

10 

4 

RIVER  GAGE 

XBOUNDPYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYCO 

NSTDIS 

1 

10 

10 

3 

RIVER 

YEOUN DRY I NIRPELV 

1 

17 

75 

2 

1  BDRYl 

YBOONDRYIN 

TRPELV 

30 

17 

75 

2 

1  BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.6667 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

3TABFLOWS 

TFRECORD 

14 

3IRREG1NT 

TABFLOW 

0. 

0.0 

0. 

0.0 

TABFLOW 

0. 

6.0 

0. 

0.00625 

TABFLOW 

0. 

10.0 

0. 

0.0125 

TABFLOW 

0. 

16.0 

0. 

0.025 

TABFLOW 

0. 

20.0 

0. 

0.0375 

TABFLOW 

0. 

26.0 

0. 

0.0625 

TABFLOW 

0. 

42.0 

0. 

0.15 

TABFLOW 

0. 

50.0 

0. 

0.19375 

TABFLOW 

0. 

54.0 

0. 

0.2125 

TABFLOW 

0. 

58.0 

0. 

0.2275 

TABFLOW 

1. 

2.0 

0. 

0.24 

TABFLOW 

1. 

6.0 

0. 

0.24625 

TABFLOW 

1. 

8.0 

0. 

0.25 

TABFLOW 

24. 

0.0 

0. 

0.25 

XBARRIER 

17 

14 

14 

2.5 

XBl 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

XBARRIER 

20 

18 

18 

2.5 

XB5 

YBARRIER 

13 

17 

17 

2.5 

YBl 

YBARRIER 

14 

18 

19 

2.5 

YB2 

YBARRIER 

15 

20 

21 

2.5 

YB3 

YBARRIER 

16 

22 

23 

2.5 

YB4 

YBARRIER 

16 

17 

18 

2.5 

YB5 

YBARRIER 

17 

19 

20 

2.5 

YB6 

YBARRIER 

18 

21 

23 

2.5 

YB7 

BATHSPEC 

YX 

(6X.9F8.1) 

1 

99.0 

99.0 

99.0 

99.0 

99.0 

99.0  99.0 

ENGLISH 


99.0 
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Table  4-13 

Output  Summary  for  the  River  Discharge  Simulation 


COASTAL  MODELING  SYSTEM  (CMS):  N1FM2D,  VERSION  1.0 


NIFM  SIMULATION  NO.  4:  TIDE  WITH  RIVER  DISCHARGE 


6ENSPECS  CARD:  SPECIFICATION  OF  TITLE  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  notes: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COffUTATIONS 

ENGLISH 

• 

6RIDSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value:  notes: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

GRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

•  GUNITS 

SYSTEM  OF  UNITS  USED  FOR  THE  GRID 

ENGLISH 

XCELL 

NUMBER  OF  GRID  CELLS.  X  DIRECTION 

75 

*  YCELL 

NUMBER  OF  GRID  CELLS.  Y  DIRECTION 

30 

DX 

SPATIAL  STEPS! ZE  IN  X  DIRECTION 

500.00 

•  DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTION 

1000.00 

GLATT 

LATITUDE  OF  GRID  ORIGIN  (DEGREES) 

0.00 

•  SL0N6 

LONGITUDE  OF  GRID  0RI6IN  (DEGREES) 

C.00 

GALIGN 

GRID  ROTATION  FOR  EAST  (DEGREES) 

0.00 

* 

««««•  TIHESPEC  CffiD:  SPECIFICATION  OF  QmiTATlONAL  TIME  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

CELT 

COffUTATlONAL  TIME  STEP  (SECOWS) 

30.0 

*  TUNITS 

TIME  UNITS  FOR  ALL  HFUT  VARIABLES 

SECONDS 

TPROV 

TIME  AT  START  OF  MODEL  SIMULATION 

0.0 

•  THAI 

TOTAL  TIIC  OF  SIMULATION 

86400.0 

DTGAGS 

TI«  INTERVAL  .0  SAVE  GAGE  OATA 

360.00 

»  DTHOTS 

TINE  INTERVAL  TO  SAVE  HOTSTARTS 

86400.00 

COASTAL  MODELING  SYSTEM  (CMS):  NIFN2D.  VERSION  1.0 


«*«•*  HYDROGRAPH  AND  VELOCITY  KASURENENTS:  3  GAGES 


GAGE 

GAGE-POSITION 

VELOCITY -fCASURSCNT 

NUMBER: 

X  Y  NOTES: 

TYPE:  NOTES: 

r/inr  iiaic* 

1 

19  16 

UAV6VAVG 

HUT  GAGE 

2 

42  15 

UAVGVAVG 

OCEAN  GAGE 

3 

10  4 

UAV0VAV6 

RIVER  GAGE 

«•«*«  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA  « 
NURBER  • 

STARTING 

X  CELL 

ENDING 

X  CELL 

STARTING 
Y  CELL 

ENDING 

Y  CELL  NOTES: 

«  Tires  TO  PRINT 

«  START  AT  END  AT 

(SECoos ):  * 

INTERVAL  NOTES:  * 

VARIABLE  FIELD 

ARRAYS  TO  PRINT:  NOTES: 

1  « 

X=  I 

X=  75 

Y*  I 

Y*  30 

*  0.0  86400.0 

43200.0  • 

E 
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Figure  4-25.  Elevation  plots  for  the  river  discharge  simulation 
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Figure  4-26.  Velocity  plots  for  the  wind- induced  setup  simulation,  gages  1  and  2 
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Figure  4-27.  Velocity  plot  for  the  wind- induced  setup  simulation,  gage 


Storm  Surge  Example 


172.  The  final  example  simulates  a  hurricane  in  the  Gulf  of  Mexico  and 
the  associated  storm  surge  that  would  inundate  the  coastal  United  States.  The 
study  area  extends  in  the  longshore  direction  from  Sabine  Lake,  Louisiana,  to 
the  Mississippi  River  mouth  (Figure  4-28).  The  grid's  northern  boundary  was 
chosen  so  that  Grand  Lake  and  Vermilion  Bay  are  included  in  the  model,  and  the 
southern  boundary  extends  beyond  the  Continental  Shelf. 

173.  The  grid's  origin  was  arbitrarily  chosen  at  its  southwest  corner. 
(Any  of  the  four  corners  can  be  chosen  as  the  origin.)  Thus,  the  x-axis 
corresponds  with  the  longshore  axis,  and  the  y-axis  extends  in  the  landward 
direction.  The  grid  covers  approximately  335  n.m.  in  the  x-direction  and 
160  n.m.  in  the  y-direction  and  is  aligned  at  an  angle  of  340.0  deg,  measured 
counterclockwise  from  east  to  the  x-axis.  At  this  angle,  the  x-axis  roughly 
parallels  the  shoreline,  providing  a  smooth  representation  of  the  land-water 
interface.  Alignments  that  produce  jagged,  "saw-tooth"  shorelines  should  be 
avoided  because  surface  friction  effects  would  not  be  properly  imposed  on  the 
wind  field.  The  grid  is  composed  of  194  cells  in  the  x-direction  and  96  cells 
in  the  y-direction,  with  a  variable  cell  width.  Greater  resolution  is  needed, 
particularly  in  the  bay  areas,  to  accurately  represent  the  hydraulic  features 
influencing  currents  and  water  levels.  Typically,  a  grid  used  for  hydrody¬ 
namic  modeling  has  cell  widths  of  100  to  500  ft  in  channel  and  inlet  areas, 
and  cell  widths  of  approximately  10,000  ft  along  the  outer  seaward  boundary. 
Additional  guidance  in  generating  grids  is  contained  in  Appendix  A  of  the  CMS 
User's  Manual. 

174.  This  problem  is  a  hindcast  simulation  of  a  hypothetical  hurricane 
striking  the  Louisiana  coast.  Figure  4-29  illustrates  the  track  of  the 
hypothetical  hurricane  as  it  travels  across  the  Gulf  of  Mexico  and  the 
southern  United  States. 

175.  The  simulation  began  at  0000  GMT  14  August  1985  and  concluded  48 
hr  later  at  0000  GMT  16  August  1985.  The  hurricane  reached  landfall  at 
approximately  1630  GMT  15  August  1985,  or  at  simulation  time  40  hr.  The 
simulation  was  started  40  hr  before  landfall  so  that  the  model  would  have 
sufficient  time  in  which  to  develop  accurate  circulation  fields.  In  addition, 
starting  with  low  wind  velocities  would  prevent  the  formation  of  artificial 
waves  induced  by  shocking  the  model  with  high  wind  velocities. 
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28 .  Study  area  for  the  storm  surge  examp 


176.  For  the  first  18  hr  during  the  simulation,  the  hurricane  could  be 
classified  as  a  tropical  storm  with  wind  speeds  increasing  from  35  knots,  at 
0000  GMT  14  August  1985,  to  60  knots  at  1800  GMT  14  August  1985.  During  this 
period,  its  forward  speed  remained  fairly  steady  within  the  range  of  11.5  to 
12.4  knots,  while  its  central  pressure  dropped  from  1,010  to  1,001  mb. 

177.  At  0000  GMT  15  August  1985,  having  wind  speeds  of  70  knots,  the 
hurricane  could  be  classified  as  a  category  1  hurricane  on  the  Saffir-Simpson 
scale.  Central  pressure  steadily  dropped  from  997  to  987  mb  at  the  time  of 
landfall,  and  wind  speeds  increased  80  knots.  For  the  next  20  hr,  the 
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hurricane  steadily  lost  intensity  as  it  moved  inland,  with  maximum  wind  speeds 
diminishing  to  30  knots,  and  the  central  pressure  increased  to  1,000  mb.  A 
summary  of  hurricane  parameters  in  presented  in  Table  4-14. 


Table  4-14 
Hurricane  Parameters 


Date 

Time 

GMT 

8/14 

0000 

8/14 

0600 

8/14 

1200 

8/14 

1800 

8/15 

0000 

8/15 

0600 

8/15 

1200 

8/15 

1630 

8/15 

1800 

8/16 

0000 

Position 


Lat 

Lone 

23.7 

90.0 

24.4 

90.3 

25.1 

90.6 

25.9 

91.0 

26.8 

91.5 

27.8 

92.2 

28.9 

92.6 

29.6 

92.7 

30.0 

92.7 

31.0 

92.4 

CPI 

Wind 

mb 

knots 

1010 

35 

1007 

45 

1004 

50 

1001 

60 

997 

70 

995 

75 

988 

80 

987 

80 

988 

70 

992 

50 

178.  This  test  problem's  input  data  set  is  presented  in  Table  4-15,  and 
the  output  summary  is  given  in  Table  4-16.  Uniform  flux  boundary  conditions 
were  specified  on  the  lateral  boundaries  to  allow  inflow  and  outflow  from  the 
computational  domain.  The  offshore  boundary  was  specified  by  interpolating 
between  six  tidal  forcing  functions  because  tidal  amplitudes  and  phases  can 
vary  significantly  along  an  extensive  study  area.  Hydrographs  for  four  gage 
locations  are  given  in  Figure  4-30.  Gage  1  is  in  the  direct  path  of  the 
hurricane  and  experiences  a  greater  surge  elevation  than  gages  2  and  3. 

Gage  4  is  located  on  land  to  show  flooding  as  the  storm  surge  inundates  the 
area.  Figure  4-31  shows  the  wind  speed  and  direction  along  with  the  pressure 
head  experienced  at  gage  1. 
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Table  4-15 

Input  Data  Set  for  the  Storm  Surge  Simulation 


GENSPECS  STORM  SURGE  EXAMPLE 

ENGLISH 


GRIDSPECVARIABLE 

ENGLISH 

194 

96 

38216.3 

38216.3 

28.6 

94.6667 

343.00 

TIMESPEC 

60.0 

SECONDS 

0.0 

172800. 

900. 

172800. 

PRWINDOW 

100 

118 

40 

50 

21600. 

21600. 

EV 

RECGAGE 

33 

33 

uv 

STATION 

1 

RECGAGE 

126 

48 

uv 

STATION 

2 

RECGAGE 

107 

31 

uv 

STATION 

3 

RECGAGE 

30 

38 

uv 

STATION 

4 

FDRYSPEC 

15. 

-15. 

0.4 

300. 

300. 

4.0 

0.200 

XBOUNDRYUNI  FLUX 

193 

2 

79 

EAST 

OPEN 

XBOUNDRYUNI FLUX 

1 

2 

25 

WEST 

OPEN 

YBOUNDRYINTRPELV 

1 

1 

8 

1 

2 

SOUTH  SEA 

YBOUNDRYINTRPELV 

1 

8 

35 

2 

3 

YBOUNDRYINTRPELV 

1 

35 

155 

3 

4 

YBOUNDRYINTRPELV 

1 

155 

177 

4 

5 

YBOUNDRYINTRPELV 

1 

177 

194 

5 

6 

WINDSPEC 

SPHVARIABLE 

KNOTSMILLIBAR 

900.0 

SPHSPEC  1014 

.000 

15.0 

60.0 

168.0 

11.7 

TABS PH 

00. 

00. 

23.700 

90.000 

1010.00 

60.0 

35.0 

121.0 

15.0 

TABS PH 

06. 

00. 

24.400 

90.300 

1007.00 

60.0 

45.0 

121.0 

15.0 

TABS PH 

12. 

00. 

25.100 

90.600 

1004.00 

60.0 

50.0 

121.0 

15.0 

TABSPH 

18. 

00. 

25.900 

91.000 

1001.00 

60.0 

60.0 

121.0 

15.0 

TABS PH 

24. 

00. 

26 . 800 

91 . 500 

997.00 

50.0 

70.0 

121.0 

15.0 

TABSPH 

30. 

00. 

27.8 

92.2 

995.00 

45.0 

75.0 

121.0 

15.0 

TABSPH 

36. 

00. 

28.9 

92.6 

988.00 

40.0 

80.0 

120.0 

15.0 

TABSPH 

40. 

30. 

29.6 

92.7 

987.00 

40.0 

80.0 

119.0 

15.0 

TABSPH 

42. 

00. 

30.0 

92.7 

988.00 

40.0 

70.0 

119.0 

15.0 

TABSPH 

48. 

00. 

31.000 

92.400 

992.00 

37.0 

50.0 

119.0 

15.0 

TABSPH 

54. 

00. 

32.000 

92.000 

997.00 

37.0 

40.0 

119.0 

15.0 

TABSPH 

60. 

00. 

32.900 

91.400 

1000.00 

37.0 

30.0 

119.0 

15.0 

FUNCTION 

1HARMCNST 

FEET 

1.3 

0.0 

0.0 

0.0 

CNRECORD 

94.6 

1985 

8 

14 

0.0 

PHY. COR. 

AND  TIME  OF 

CONSTITU. 

CONSTIT 

01 

0.50 

18.8 

CONSTIT 

K1 

0.52 

26.8 

CONSTIT 

PI 

0.15 

19.8 

CONSTIT 

M2 

0.23 

258.9 

CONSTIT 

S2 

0.08 

239.5 

FRICTION  MANNING 
FRICTABL  0.025 
FRICTABL  0.025 
FRICTABL  0.025 
FRICTABL  0.025 
FRICTABL  0.025 


QUADRATVARYBATH 

-300.0 

-100.0 

-30.0 

-1.0 

3.0 
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Table  4-16 


Output  Summary  for  the  Storm  Surae  Simulation 


COASTAL 


MODELING 


SYSTEM  (CMS):  N  1  F  M  2  B  ,  VERSION  1.0 

HIFM  SIMULATION  NO.  2:  TIDE  WITH  NQM.INEAR  TERMS  - 


*««*»  SENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

»  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

t 

••«*«  GRIOSPEC  CARO:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

VARIABLE 

value: 

NOTES: 

GRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

SUNITS 

SYSTEM  OF  UNITS  USED  FOR  THE  ERID 

ENGLISH 

XCEll 

NUMBER  OF  GRID  CELLS,  X  DIRECTION 

75 

YCELL 

NUMBER  OF  GRID  CELLS.  Y  DIRECTION 

30 

DX 

SPATIAL  STEPSIZE  IN  X  DIRECTION 

500.00 

DY 

SPATIAL  STEPSIZE  IN  Y  DIRECTION 

lOOC.OO 

6LATT 

LATITUDE  OF  GRID  0RI6IN  (DEGREES) 

0.00 

GL0N6 

LONGITUDE  OF  GRID  ORIGIN  (DEGREES) 

C.00 

GALIGN 

GRID  ROTATION  FOR  EAST  (DEGREES) 

0.00 

TIMESPEC  CARD:  SPECIFICATION  OF  COMPUTATIONAL  Tift  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

BELT 

COMPUTATIONAL  TINE  STEP  (SECOWS) 

30.0 

TUNITS 

TIME  UNITS  FOR  ALL  IIPUT  VARIABLES 

SECONDS 

TPROV 

TIME  AT  START  OF  HOOEL  SIMULATION 

0.0 

THAT 

TOTAL  TIME  OF  SIMULATION 

73600.0 

DTGASS 

Tift  INTERVAL  TO  SAVE  SAGE  DATA 

360.00 

DTHD7S 

TIME  INTERVAL  TO  SAVE  HOTSTARTS 

75600.00 

ADDTERMS  CARD:  SPECIFICATION  OF  ADDITIONAL  TERMS 

IN  GOVERNING  EOLATIONS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

• 

* 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

ADVTYP 

GOVERNS  USE  OF  ADVECTION  TERMS 

NONCONS 

* 

t 

DIFTYP 

GOVERNS  USE  OF  DIFFUSION  TERMS 

CONSTDIF 

DIFCOF 

DIFFUSION  COEFFICIENT 

5.0000 

• 

ADMASS 

HATER  MASS  FLUX  INTO  SYSTEM 

0.0000 

*****  STARTUP  CAW):  SPECIFICATION  OF  INITIAL  CONDITIONS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

• 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES: 

SELEV 

INITIAL  HATER  SURFACE  ELEVATION 

4.048 

» 

SECHO 

AMOUNT  OF  INPUT  DATA  TO  BE  PRINTED 

SHORT 
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Figure  4-30.  Elevation  plots  for  the  storm  surge  simulation 
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Figure  4-31.  Wind  and  pressure  at  gage 
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APPENDIX  4- A:  WIFM  DATA  SPECIFICATION  RECORDS 
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Model  Control  Specifications 


(Req)  GENSPECS 
(Req)  TIMESPEC 
(Opt)  ADDTERMS 
(Opt)  STARTUP 


Specify  general  title  and  system  of  units 
Specify  time -related  controlling  variables 
Specify  optional  terms  in  governing  equations 
Specify  initial  conditions 


(Req)  GRIDSPEC 
(C-Opt)  XSTRETCH 
(C-Opt)  YSTRETCH 


(Req)  BATHS PEC 
(Req) 

(Opt)  CHNGBATH 
(Opt)  FDRYSPEC 
(Opt)  XBARRIER 
(Opt)  YBARRIER 
(Opt)  BARRS PEC 
(Opt)  FRICTION 
(Opt)  FRJCTABL 
(Opt)  CHNGFRIC 
(Opt)  TURNOFF 


(Opt)  XBOUNDARY 

(Opt)  YBOUNDARY 

(C-Opt)  FUNCTION 
(C-Opt)  CNRECORD 
(C-Opt)  CONSTIT 


Grid  Description 

Specify  general  grid  characteristics 
Specify  x- coordinates  to  create  stretched  grid 
Specify  y- coordinates  to  create  stretched  grid 

Physical  Characteristics 


Specify  characteristics  of  bathymetry/topography 

Two-dimensional  array  of  bathymetric/topographic 
data 

Specify  changes  to  the  bathymetric/topographic  data 
Change  the  flooding  and  drying  defaults 
Specify  barrier  perpendicular  to  x-axis 
Specify  barrier  perpendicular  to  y-axis 
Specify  characteristics  of  barrier  behavior 
Specify  character  of  bottom  friction 
Specify  entry  for  depth-variable  friction  table 
Modify  the  friction  values  at  selected  locations 
Remove  portions  of  the  grid  from  computations 


Boundary  Conditions 


Specify  driving  boundary  perpendicular  to  x-axis 
Specify  driving  boundary  perpendicular  to  y-axis 
Specify  driving  boundary  forcing  function 
Specify  attributes  of  constituent  forcing 
Specify  harmonic  constituent  forcing  function 
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(C-Opt)  TERECORD  Specify  attributes  of  tabular  elevation  forcing 

Boundary  Conditions  (Concluded) 


(C-Opt)  TFRECORD 
(C-Opt)  TABELEV 
(C-Opt)  TAB FLOW 


Specify  attributes  of  tabular  velocity  forcing 
Specify  irregularly  spaced  tabular  elevations 
Specify  irregularly  spaced  tabular  velocities 


Wind  Field  Specifications 


(Opt)  WINDSPEC 
(C-Opt)  SPHSPEC 
(C-Opt)  TABSPH 
(C-Opt)  TABWINDS 


Specify  the  character  of  wind- field  data 
Specify  general  data  for  SPH  wind- field  model 
Specify  the  SPH  parameters  at  a  given  time 
Specify  wind- field  tabular  data 


Output  Specifications 


(Req) 

PRWINDOW 

Specify 

(Opt) 

RECGAGE 

Specify 

(Opt) 

RECSNAPS 

Specify 

(Opt) 

XRECRANG 

Specify 

(Opt) 

YRECRANG 

Specify 

location  and  timing  of  a  print  window 
location  of  recording  gage  in  grid 
snapshot  time(s)  for  recording 
discharge  range  perpendicular  to  x-axis 
discharge  range  perpendicular  to  y-axis 
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CMS  Data  Specification:  GENSPECS  Record:  (Req) 

Purpose:  Specify  general  title  and  system  of  units. 
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CMS  Data  Specification:  STARTUP  Record:  (Opt) 

Purpose:  Specify  inital  conditions. 


CMS  Data  Specif iaction:  ADDTERMS  Record:  (Opt) 

Purpose:  Specify  optional  terms  in  governing  equations. 
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CMS  Data  Specification:  XSTRETCH  and  YSTRETCH  Records:  (C-opt) 

Purpose:  Specify  the  data  to  create  grid  coordinates  in  a  stretched  rectilinear 

Cartesian  coordinate  system. 


00 

« 

u 

•Q  c 

3  o 

(0 

00 

•O  <U 

*i"4  U 

Vi  33 

00  3 

co 

4-1 

O  T) 


00  T3 
4)  C 
33  4) 


v>  XX 

y  «ou 

V  u  H  H 
t4  4  Ed  Ed 

eaXai 
HH 
iu  nn 
C4  X>< 


>  a  ea2 

a>  C  .  -i- 

o  h 

•  C  4-i  5 

o 

I  *H  4) 

!  0043* 

I  4)  U 
n  cd 
X>  4-1 
13  0  + 
co 

!_  C  < 

:i3  o 

l  *H  | 

u  u 

!  BOCX 

*  y 

I 

I  -h  t-i 
134  0 
,  y  a)  w 

>  > 

>  3  o  X 

)  *h  a 


***,*,*, 

n  m  t*:  ej4  x 


00 

Vi 

Vl 

* 

4) 

4) 

00 

00 

Vc 

4) 

4) 

H 

.—I 

4 

V) 

V) 

fld 

4 

33 

C 

c 

0) 

4) 

U 

M 

M 

03 

•*4  -Ed-4 

00  0)  Ed  EX 
0)  00X  p 
Bi  «H  O 

■M  Ed  O 
•  O  O  O 

4)  a)  vy 

•*4  EXH 

O  ON 

■  a  44  • 

1-4  M  VO 

4  X  ’O^ 
t4  (J  0)  O 
V>  CO  14 
C  £  44  4) 
4)  U  -4  33 
3  l> 
cr  a>  a)  "O 
0)33  CXr4 
W  V>  0)  3 

o 

«  a  m3: 

33  *H  <fl  CO 

V>  H  33 

(0  W  x  o 

3  04  u  4 

C  « 

0  33  VJ  4 
i4  id  b 

00*0  G 

V  4)44  O 
>4  4->  i4  44 
n  (d 

3  43H 

«  4)  4)  4 
(3  Vi  **4 
1)4140 
14  003  4) 

m  tro. 

00  4)  4)  CO 
33  Vi 

Vi  4 
4)  X4> 
0.4  4  11 

■o  0  *  3 

Vi  CO  CO 
O  *0  *0  U 
O  Vi  Vi 
4)  O  0*0 
4UUC 
4)  4)  4 

4  Vl  M 

C3  " 

O  4)  4)  SQ 
CO  10 

4)  4)  4)  * 

see*1 


CQ  1-V/-N1-V/-V 
4)  r4  04  rO  -y 

O 

as 


4-95 


CMS  Data  Specification:  TURNOFF  Record:  (Opt) 

Purpose:  Turn  off  (remove  from  computations)  portions  of  grid. 
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CMS  Data  Specification:  BATHSPEC  Record:  (Req) 
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The  actual  2-D  array  of  bathymetry/ topography  data  follows  this  record. 

Conventions  for  2-D  array  read  sequence  mnemonics: 

**********  SEQ  -  XY  *******************  *****************  SEQ  -  YX  ******************** 

DO  1  J-l.YCELLS  DO  5  I-l.XCELLS 

READ (LUN, FORM)  (VAR(I , J) , 1-1 .XCELLS)  5  READ ( LUN , FORM)  (VAR(1 , J) , J-l , YCELLS) 
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CMS  Data  Specification:  FDRYSPEC  Record:  (Opt) 

Purpose:  Change  the  flooding  and  drying  defaults. 
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CMS  Data  Specification:  FRICTION  Record:  (Opt) 

Purpose:  Specify  character  of  bottom  friction. 
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CMS  Data  Specification:  CHNGFRIC  Record:  (Opt) 

Purpose:  Modify  the  friction  values  at  selected  locations. 
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CMS  Data  Specification:  XBARRIER  and  YBARRIER  Records:  (Opt)  ,  ,  . 

Purpose:  Specify  the  location  and  characteristics  of  a  subgrid-scale  barrier. 


CMS  DaCa  Specification:  BARRSPEC  Record:  (Opt) 
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CMS  Data  Specification:  XBOUNDRY  and  YBOUNDRY  Record:  (OPT) 

Purpose:  Specify  location  and  character  of  a  driving  boundary. 
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(Continued) 


CHS  Data  Specification:  character  of  driving  boundary  forcing  function. 
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FSHIFT  Real  (Opt)  0.  R*  The  function  values  are  shifted  in  time 

by  this  amount  (in  TUNITS). 

NOTE:  +  Shift  forward  in  time 
-  Shift  backward  in  time 
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CMS  Data  Specification:  CONSTIT  Record:  (C-opt) 

Purpose:  Specify  and  quantify  a  harmonic  constituent  for  a  boundary  forcing  function. 
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must  follow  this 


CMS  Data  Specification:  TABELEV  or  TABFLOW  Records:  (C-Opt) 

Purpose:  Specify  the  time  and  value  of  an  entry  in  an  irregularly  spaced  tabular 

elevation  or  flow  forcing  function. 
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WINTRP  Real  (Opt)  0.  +R*  Time  interval  (in  TUNITS)  to  interpolate 

wind  field  from  given  values. 


^  fix 
•pi  OH 
>  U 

c 

H  O  O 
<-H  JS  J3 
0.4J  U 


u  u  z  a 

h  c  cd  5  9 

O  OHH 

c 

■H  O  O 

<W  M  &.C 

<U  M  *H 

4J 

e 

•d  *w  <u 

V 

• 

C  3  4-> 

> 

•o 

*H  CT  C  X) 

« 

V 

>  *rH  O 

u 

a  *h 

•o 

V 

O  O  h  h 

c 

•H 

ih  o  o 

H  — '  (X, 

•H 

a 

at 

o 

01 

« 

u  o 

* 

«  w 

Oi 

M 

01  tO 

«d 

<S 

•ox 

0) 

s: 

c  &■ 

04 

CJ 

4-115 


CMS  Data  Specification:  SPHSPEC  Record:  (C-opt) 

Purpose:  Specify  general  data  to  be  employed  by  an  SPH  wind- field  model. 


CMS  Data  Specification:  TABSPH  Record:  (C-opt) 

Purpose:  Specify  the  SPH  parameters  at  a  given  time. 
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(1)  At  least  one  TABSPH  record  must  follow  an  SPHSPEC  record. 
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CMS  Data  Specification:  PRWINDOW  Record:  (Opt) 

Purpose:  Specify  location  and  timing  of  a  print  window. 
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Note:  Use  1  PRWINDOW  record/window  (in  space  or 


CMS  Data  Specification:  RGCGAGE  Record:  (Opt) 

Purpose:  Specify  location  and  character  of  a  recording  gage  in  the  grid. 
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CMS  Data  Specification:  RECSNAPS  Reocrd:  (Opt) 

Purpose:  Specify  snapshot  time(s)  for  recording. 
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CHS  Data  Specification:  XRECRANG  and  YRECRANG  Records:  (Opt) 

Purpose:  Specify  location  and  name  of  a  discharge  recording  range  within  the  grid. 
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CHAPTER  5 

REGIONAL  COASTAL  PROCESSES  WAVE  PROPAGATION  MODEL 
THEORY  AND  PROGRAM  DOCUMENTATION 


PART  I :  INTRODUCTION 

1.  This  chapter  documents  the  Regional  Coastal  Processes  Wave  (RCPWAVE) 
Propagation  Model.  RCPWAVE  is  a  short-wave  numerical  model  used  to  predict 
linear,  plane  wave  propagation  over  an  open  coast  region  of  arbitrary  bathyme¬ 
try.  The  goal  of  regional  modeling  is  to  determine  coastal  changes  resulting 
from  natural  forces  and  man-made  structures  over  an  extensive  length  of 
coastline.  RCPWAVE  uses  linear  wave  theory  because  it  has  >een  shown  to  yield 
fairly  accurate  first-order  solutions  to  wave  propagation  problems  and  at  a 
relatively  low  cost.  Refractive  and  bottom- induced  diffractive  effects  are 
included  in  the  model;  however,  the  model  cannot  treat  diffraction  caused  by 
surface-piercing  structures.  Application  of  this  model  does  not  include 
nonlinear  effects  nor  a  spectral  representation  of  irregular  waves. 

2.  RCPWAVE  has  evolved  as  it  has  been  applied  to  wave  propagation 

problems  (Ebersole,  Cialone,  Prater  1986).  The  model  results  can  be  used  as  a 

forcing  function  to  drive  models  that  calculate  longshore  and  cross-shore 

sediment  transport  (Hanson  and  Kraus  1989).  For  example,  RCPWAVE  has  been 
used  in  conjunction  with  the  shoreline  change  model,  GENESIS,  for  mission 

support  projects  at  Homer  Spit,  Alaska  (Chu  et  al.  1987);  Sea  Bright  to  Ocean 

Township,  New  Jersey  (Kraus  et  al.  1988);  and  Asbury  Park  to  Manasquan,  New 
Jersey  (Gravens  et  al .  1989). 

3.  Berkhoff  (1972,  1976)  derived  an  elliptical  equation  to  approximate 
the  complete  wave  transformation  process  for  linear  waves  over  arbitrary 
bathymetry  with  the  restriction  of  a  mild  bottom  slope.  By  substituting  the 
velocity  potential  into  the  elliptic  mild  slope  equation  and  solving  the  real 
and  imaginary  parts  separately,  two  equations  are  derived.  RCPWAVE  solves 
finite  difference  approximations  of  these  equations  along  with  the  equation 
specifying  irrotationality  of  the  wave  phase  function  gradient  and  the 
dispersion  relation.  These  equations  describe  the  combined  refraction  and 
diffraction  process  for  linear  plane  waves  subject  to  the  restrictions  of  a 
small  bottom  slope.  Wave  reflections  are  assumed  to  be  negligible,  and  any 
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energy  losses  are  assumed  to  be  small  and  can  be  neglected.  These  equations 
are  valid  outside  the  surf  zone. 

4.  The  model  also  contains  an  algorithm  that  estimates  wave  conditions 
inside  the  surf  zone.  This  wave  breaking  model  is  an  extension  of  the  work  of 
Dally,  Dean,  and  Dalrymple  (1984)  to  two  horizontal  dimensions.  The  impor¬ 
tance  of  predicting  wave  transformation  within  the  surf  zone  cannot  be 
overemphasized.  Wave  action  within  the  surf  zone  Initiates  sediment  movement, 
and  prediction  of  this  movement  is  a  frequent  goal  of  coastal  modelers. 

5.  This  chapter  is  divided  into  five  sections:  Part  II  presents  the 
theoretical  development,  Part  III  defines  the  input  data  formats,  Part  IV 
discusses  the  model's  input  data  requirements,  and  Part  V  contains  two 
illustrative  examples. 
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PART  II:  THEORETICAL  DEVELOPMENT 


Assumptions  and  Limitations 

6.  Proper  application  of  any  model  requires  a  clear  understanding  of 
the  physical  processes  occurring  in  a  study  area  and  a  comprehension  of  the 
capabilities  of  a  given  model  to  simulate  those  processes.  Model  results 
should  provide  a  realistic  representation  of  the  physical  system  being 
modeled. 

7.  The  limitations  of  a  model  define  its  range  of  applicability.  In 
particular,  RCPWAVE  is  a  linear,  monochromatic,  short  wave  model.  Therefore, 
nonlinear  effects  and  irregular  waves  cannot  be  modeled.  RCPWAVE  is  a  steady- 
state  model;  therefore,  time -dependent  effects  are  not  modeled.  Refractive 
and  bottom- induced  diffractive  effects  are  included  in  the  model;  however, 
structure- induced  diffraction  is  not.  Model  applications  are  restricted  to  a 
mild  bottom  slope.  Wave  reflection  and  energy  losses  outside  the  surf  zone 
are  assumed  negligible. 

8.  A  thorough  comprehension  of  the  physical  processes  simulated  by  the 
model  is  necessary  to  ensure  that  the  model  is  applied  to  appropriate  prob¬ 
lems,  that  it  is  applied  correctly,  and  that  accurate  results  are  produced.  A 
discussion  of  the  governing  equations  used  in  RCPWAVE  is  provided  in  the 
following  section.  It  is  recommended  that  the  reader  refer  to  Horikawa  (1988) 
or  Dean  and  Dalrymple  (1984)  for  a  detailed  discussion  of  coastal  hydrodynam¬ 
ics,  particularly  linear  wave  propagation. 

GoverninE  Equations  Outside  the  Surf  Zone 

9.  Berkhoff  (1972,  1976)  derived  an  elliptical  equation  to  approximate 
the  complete  wave  transformation  process  for  linear  waves  over  an  arbitrary 
bathymetry  with  the  restriction  of  a  mild  bottom  slope.  Berkhoff' s  "mild 
slope"  equation  is: 
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where 


*.  7 

- 

two  orthogonal  horizontal  coordinate  directions 

(x.y) 

- 

wave  celerity  (-  a/k ) 

a 

- 

angular  wave  frequency  (defined  to  be  2w/T ) 

k(x,y ) 

- 

wave  number  given  by  the  dispersion  relation 
a2  -  gk  canh  (kh) 

T 

- 

wave  period 

c%  (x,y) 

- 

group  velocity  ( do/dk ) 

4>(x,y) 

- 

complex  velocity  potential 

g 

- 

acceleration  due  to  gravity 

h(x,y) 

- 

still -water  depth 

10.  If  one 

considers  only  the  forward  scattered  wave  field  and  neglects 

reflection, 

the 

velocity  potential  function  for  linear,  monochromatic 

plane  waves  can  be  given  as : 

^  =  aeu  (5-2) 


where 


a(x,y)  - 
H(x,y)  - 
s(x,y)  - 
11.  By 
and  imaginary 


wave  amplitude  function  [gH(x,y)/2o] 

wave  height 

wave  phase  function 

substituting  Equation  5-2  into  Equation  5-1  and  solving  the  real 
parts  separately,  two  equations  can  be  derived: 
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V  •  ( a2ccgVs )  •  0  (5-4) 

where  the  symbol  V  denotes  the  horizontal  gradient  operation.  These 
equations  describe  the  combined  refractive -diffractive  process. 

12.  Linear  wave  theory  assumes  irrotationality  of  the  wave  phase 
function  gradient.  This  property  can  be  expressed  mathematically  as: 

Vx(Vs)  »  0  (5-5) 

The  phase  function  gradient,  Vs  ,  can  be  written  in  vector  notation  as 
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Vs  ■  |Vs|coa0i  +  |Vs|sin8J 


(5-6) 


where 

i,  j  «  unit  vectors  in  the  x-  and  y-directions ,  respectively 
| Vs |  -  magnitude  of  the  phase  function  gradient 
6  -  local  wave  direction 

Equations  5-5  and  5-6  can  be  combined  to  yield  the  following  expression: 

-^(|Vs|sin6)  -  -^(|Vs|sin0)  =  0  (5-7) 

If  the  magnitude  of  the  wave  phase  function  gradient  is  known,  local  wave 
angles  can  be  calculated  from  Equation  5-7.  Similarly,  Equation  5-4  can  be 
expressed  as: 

-^(a2ccff|Vs|  cos0)  ♦  ~~  (a2ccg |Vs|  sin6)  =  0  (5-8) 


Equation  5-3  is  solved  for  the  magnitude  of  the  wave  phase  function  gradient, 

| Vs |  ;  Equation  5-7  is  solved  for  the  wave  angle,  8  ;  and  Equation  5-8  is 
solved  for  the  wave  amplitude  function,  a  .  Equations  5-3,  5-7,  and  5-8 
along  with  the  dispersion  relation  describe  the  combined  refractive - 
diffractive  process  for  linear  plane  wave  propagation  over  a  mild  slope  with 
negligible  wave  reflection  and  energy  losses. 

Numerical  solution 

13.  Numerical  methods  are  used  to  solve  the  three  governing  equations 
described  previously.  Analytical  solutions  of  the  governing  equations  may 
exist  for  idealized  situations.  However,  it  is  generally  necessary  to  use 
numerical  approximations  of  the  governing  equations  to  provide  a  more  general 
solution.  This  is  accomplished  by  approximating  the  partial  derivatives  with 
finite  ifference  operators  (i.e.  resolving  the  continuous  domain  of  interest 
with  discrete  spatial  increments).  Finite  difference  solution  methods  operate 
on  a  computational  grid  system.  Solution  accuracy  is  directly  related  to 
resolution  within  the  grid  system. 

14.  The  coordinate  system  convention  adopted  by  RCPWAVE  is  oriented 
with  the  x-axis  in  the  on-offshore  direction  and  the  y-axis  alongshore 
(Figure  51).  The  grid  cells  have  constant  lengths  of  DX  and  DY  in  the  x-  and 
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y-directions ,  respectively.  The  cell  counter  in  the  x-direction,  i  ,  ranges 
from  1  to  a  maximum  value  of  XCELLS.  The  cell  counter  in  the  y- direct ion, 
j  ,  ranges  from  1  to  a  maximum  value  of  YCELLS. 

15.  As  previously  stated,  the  partial  derivatives  in  the  governing 
equations  are  approximated  with  finite  difference  operators.  The  first  and 
second  derivatives  of  an  arbitrary  dependent  variable,  say  F,  are  approximated 
with  the  following  finite  difference  operators: 


&F  m  2fi,j  ~  5Fui,j  *  *Fi+2,j  ~  (5-9) 

dx2  (Ax)2 

«  Fi.m  ~  2Fi.i  *  Fi.i- i  (5-10) 

dy2  (Ay)2 

if  «  ~3Fi.J  *  *Fi*i.i  ~  Fi*.i  (5-11) 

dx  2  Ax 

if  .  ~  (5-12) 

dy  2  Ay 


J  = 


Figure  5-1.  Definition  of  coordinate  system 
and  grid  cell  convention 
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16.  Equations  5-10  and  5-12  are  central  differences,  and  Equations  5-9 
and  5-11  are  backward  differences  of  the  same  order  of  accuracy.  Backwards 
differences  are  used  to  approximate  the  derivatives  in  the  x- direction  because 
of  the  forward  ( -x-direction)  marching  scheme  used  in  the  model. 

17 .  These  difference  equations  can  be  used  to  approximate  the  partial 
derivatives  in  Equation  5-3: 
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The  remaining  two  governing  equations,  5-7  and  5-8,  have  the  general  form: 

H  =  Q  (5-14) 

ox  oy 

The  partial  derivatives  in  equation  5-14  can  be  approximated  using  central 
differences  about  the  point  (i-1/2 ,j) .  The  final  form  of  Equations  5-7  and 
5-8  are: 

=  -j^-^[(«|Vs|J<i+lsinei>in  +  (1  -  2«)  sin6i>:, 


-  lVsli-i,i-i cos0i-i,i-i)  -  —  2Ay~~(^g|i,^*lC°8 


~  \VB\i,j-ic°B*i.j-i)] 
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and 
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where 


A  -  ccg|Vs|  cos  0, 

B  -  ccg|VsJ  sin  6, 

W  ,  a  -  weighting  factors 

The  parameter  1/  weights  information  between  the  known  row,  i  ,  and  the 
solution  row,  i-1.  If  W  is  1.0,  then  an  implicit  solution  of  the  equation 
is  performed.  If  W  is  0.0,  then  an  explicit  solution  of  the  equation  is 
performed.  The  weighting  parameter  a  reflects  use  of  a  dissipative  inter¬ 
face  to  enhance  the  stability  of  the  numerical  scheme  (Abbott  1975)  . 

Solution  procedure 

18.  The  following  procedure  is  implemented  in  the  model  to  solve 
finite  difference  Equations  5-13,  5-15,  and  5-16: 


a.  Model  input  includes  values  of  the  deepwater  wave  height, 

H0  ,  direction,  8a  ,  and  period,  T  ,  of  the  waves  to  be  simu¬ 
lated  along  with  bathymetric  data  for  every  grid  cell. 

b.  The  wave  number,  k  ,  is  computed  using  the  dispersion  relation 
and  is  used  as  an  initial  guess  for  the  magnitude  of  the  wave 
phase  function  gradient,  |Vs|  ,  at  every  grid  cell. 

c.  The  wave  celerity,  c  ,  and  the  group  velocity,  cg  ,  are  func¬ 
tions  of  the  wave  period  and  wave  number  and  can,  therefore,  be 
calculated  at  each  grid  cell. 

d.  An  estimate  of  the  local  wave  angle,  8  ,  can  be  calculated 
throughout  the  grid  using  this  information  and  Snell's  law, 


sin9  =  ain60 

c  <7C 


(5-17) 


where  cD  is  the  deepwater  wave  celerity  (gT/2ir)  .  This  esti¬ 
mate  assumes  that  the  bottom  contours  are  parallel  to  the  y- 
axis.  If  the  bottom  bathymetric  contours  make  a  known  nonzero 
angle,  8C  ,  with  the  y-axis  (Figure  5-2),  a  better  first  guess 
for  the  wave  angles  can  be  computed  using  the  following 
approximation: 
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Y-AXIS 


X  -  AXIS 

0,  -  DEEPWATER  WAVE  ANGLE 
0  -  LOCAL  WAVE  ANGLE 
6  -  OFFSHORE  CONTOUR  ANGLE 

Figure  5-2.  Definition  of  angle  conventions 
used  in  the  model 
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19.  Following  the  deteraination  of  the  initial  guess  for  the  variables 
of  interest,  a  row-by-row  marching  scheme  is  implemented.  Computations  begin 
at  the  offshore  row  designated  ( i-XCELLS - 3 ) ,  where  a  solution  for  wave  angles, 
heights,  and  numbers  is  determined  for  cells  j-2  to  j-YCELLS-1. 

20.  The  implicit  differencing  formulation  used  in  Equations  5-15  and  5- 
16  requires  an  iterative  procedure  to  determine  values  of  wave  height  and 
angle.  Calculations  are  repeated  until  a  convergence  criterion  is  met. 
Convergence  for  wave  height  is  achieved  when  the  difference  between  the  wave 
height  computed  from  one  iteration  to  the  next  iteration  is  less  than  a  small 
value  (0.0005  ft).  Similarly,  convergence  for  wave  angle  is  achieved  when  the 
difference  between  the  wave  angle  computed  from  one  iteration  to  the  next 
iteration  is  less  than  a  small  value  (0.00025  rad).  The  third  governing 
equation  (5-13)  is  used  to  compute  the  wave  phase  gradient  that  accounts  for 
the  effects  of  diffraction. 

21.  Equations  5-15  and  5-16  are  solved  again  with  the  new  values  of  the 
wave  phase  function  gradient.  This  procedure  is  repeated  along  the  row  under 
consideration  until  the  phase  functions  satisfy  a  convergence  criterion  (i.e., 
the  difference  in  the  phase  functions  between  consecutive  iterations  is  less 
than  0.5  percent).  This  condition  must  be  met  at  each  cell  along  the  row. 

Row  by  row  marching  proceeds  until  a  solution  is  computed  along  row  i-2. 
Boundary  conditions 

22.  Lateral  boundary  conditions  for  a  row  are  specified  upon  completion 
of  calculations  for  that  row.  The  values  of  all  variables  at  cells  j-YCELLS 
and  j-1  are  set  equal  to  the  values  at  cells  J-YCELLS-1  and  j-2,  respectively. 
This  boundary  condition  implies  that  there  is  no  change  in  wave  properties  in 
the  y-direction.  This  condition  is  most  valid  when  the  grid  y-axis  parallels 
the  bathymetric  contours . 

23.  The  seaward  boundary  condition  (deepwater  wave  parameters)  are  used 
to  initiate  the  shoreward  marching  procedure.  Values  along  the  seaward 
boundary  are  computed  from  deepwater  wave  input,  assuming  Snell's  law  is  valid 
(i.e.,  the  bottom  contours  are  straight  and  parallel  from  the  grid  boundary  to 
deep  water) .  No  inshore  boundary  condition  (row  i  -  1)  is  necessary  because 
of  the  forward  marching  scheme  implemented  in  the  model. 
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Wave  transformation  Inside  the  surf  zone 

24.  Since  linear  wave  theory  does  not  allow  for  the  prediction  of  the 
breaker  location  nor  for  wave  transformation  across  the  surf  zone,  empiiical 
and  approximate  methods  must  be  used  to  describe  incipient  wave  breaking  and 
the  subsequent  decay  of  energy.  Many  empirical  methods  give  reasonable 
approximations  of  incipient  breaking  wave  height.  RCPWAVE  uses  Weggel's 
(1972)  criterion,  which  was  developed  by  fitting  an  empirical  relationship  to 
field  data  on  breaking  waves: 


bhy 


1  + 


ahb 
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(5-21) 


where 

a  -  43.75  [  1  -  e('19m)  ] 

b  -  1.56  /  [  1  +  e^19,5”5  ] 

m  -  bottom  slope 
Hb  -  breaking  wave  height 
hb  -  water  depth  at  breaking 

25.  After  defining  the  incipient  breaking  point,  a  means  of  transform¬ 
ing  the  waves  across  the  surf  zone  is  needed.  Dally,  Dean,  and  Dalrymple 
(1984)  developed  an  algorithm  to  approximate  energy  loss  across  the  entire 
surf  zone  based  on  energy  loss  in  a  hydraulic  jump. 


d{Ecg) 

dx 


(Ecg),) 


(5-22) 


where 

k  -  energy  dissipation  coefficient  (set  to  0.2  in  RCPWAVE) 

(2Tcg)  -  energy  flux  associated  with  a  breaking  wave 

(Ecg),  -  stable  level  of  energy  flux  that  the  transformation  process 
seeks  to  attain 

The  right-hand  side  of  Equation  5-22  is  simply  a  dissipative  term.  Substitut¬ 
ing  the  linear  wave  theory  estimate  for  E  (E  -  1/8  pgH2)  into  Equation  5-22 
results  in  the  following  expression: 
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26.  It  has  been  observed  In  field  (Thornton  and  Guza  1982)  and  labora¬ 
tory  (Horikawa  and  Kuo  1966)  experiments  that,  well  into  the  surf  zone,  the 
wave  height  tends  toward  a  stable  value  that  is  proportional  to  the  local 
water  depth: 

H ,  -  yA  (5-24) 


where 

Hs  -  stable  wave  height 

7  -  proportionality  coefficient  (set  equal  to  0.4  in  RCPWAVt) 

Equation  5-23  can  now  be  written  as 


d(H2c„) 


~  (Y ah2c,).]  =  D 


(5-25) 


27.  This  surf  zone  wave  transformation  model  can  be  incorporated  into 
the  conservation  of  wave  energy  equation  (Equation  5-4)  by  simply  adding  the 
dissipation  term  D  to  the  right-hand  side.  The  function  D  must  now 
represent  dissipation  in  the  direction  of  wave  propagation.  Also  for  dimen¬ 
sional  consistency,  the  term  D  must  be  multiplied  by  the  wave  celerity  and 
the  magnitude  of  the  wave  phase  gradient,  and  the  wave  height  must  be  replaced 
by  the  wave  amplitude  function.  In  vector  notation,  the  energy  equation 
becomes 

V»(a2ccfl.Vs)  =  -^jaaccy|Vs|  -  |  |-^J2y2h3ccy|Vs|j  J  (5-26) 

This  equation  can  be  thought  of  as  being  valid  both  inside  and  outside  the 
surf  zone.  Outside,  the  coefficient  k  is  zero,  and  the  equation  reduces  to 
Equation  5-4. 

28.  Discussion  relating  to  wave  transformation  within  the  surf  zone  has 
addressed  the  problem  of  determining  wave  heights.  The  problem  of  wave  phase 
must  also  be  addressed.  Diffractive  effects  are  assumed  to  be  negligible 
inside  the  surf  zone.  Therefore,  the  wave  number,  k  ,  is  assumed  to 
accurately  represent  the  wave  phase  function  gradient  in  the  surf  zone. 


5-12 


29.  Lastly,  the  linear  wave  theory  assumption  of  lrrotationality  also 
will  be  assumed  to  remain  valid  inside  the  surf  zone.  Consequently,  wave 
angles  inside  the  surf  zone  are  computed  in  the  same  manner  that  is  used 
outside  the  surf  zone. 

Numerical  solution 

30.  The  numerical  procedure  for  computing  wave  angles  inside  and 
outside  the  surf  zone  is  the  same.  This  section  documents  the  solution  scheme 
used  to  determine  breaking  wave  heights.  The  finite  difference  form  of  the 
wave  energy  equation  outside  the  surf  zone  (Equation  5-16)  can  be  expressed  in 
the  following  form: 


-2 


F  +  A  xG 

Ai- i.j 


(5-27) 


where 


F  -  Ai.j*i  +  <1  -  2a)aj,jAitJ  +  . 

G  =  (1  -  W)  , 

B  =  ccy|Vs|ain0,  and 
A  =  cc9|Vs|  cosfl. 

With  the  inclusion  of  the  dissipative  term,  Equation  5-27  becomes 
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F  +  A  xG  +  A  xD' 


(5-28) 


where  D*  represents  the  finite  difference  form  of  the  dissipation  term  on 
the  right-hand  of  Equation  5-26.  Reiterating,  the  dissipation  term  represents 
an  average  value  along  the  wave  path  (direction  of  propagation).  The  wave 
path  is  determined  by  the  local  wave  angle  at  the  position  i-l,j  which  has 
already  been  computed.  Therefore,  the  average  along  the  path  is  an  average  of 
information  at  cell  L-l,j  and  another  cell  whose  position  is  denoted  by 
ikey , jkey .  The  procedure  used  for  determining  the  location  of  this  cell  will 
be  presented  later. 

31.  The  term  D  can  be  written  in  finite  difference  form  as 
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With  some  algebra.  Equation  5-28  can  be  reorganized  so  that  the  amplitude 
function  at  the  position  i-I, j  appears  only  on  the  left-hand  side  of  the 
equation.  Therefore,  the  energy  equation  inside  the  surf  zone  can  be  numeri¬ 
cally  solved  using  the  same  procedure  used  to  solve  it  outside  the  surf  zone. 

32.  The  location  of  the  cell  denoted  ikey,jkey  is  found  using  the 
following  procedure.  "Areas  of  influence"  are  determined  by  extending  lines 
from  the  center  of  the  cell  i-2,j  to  the  midpoints  between  the  surrounding 
cell  centers  (Figure  5-3).  Angles  are  computed  from  the  x-axis  to  these 
radial  lines.  The  local  wave  angle  calculated  at  cell  i-l,j  is  compared  with 
each  of  these  angles  in  order  to  determine  the  nearest,  prior  cell  (in  row  i) 
along  the  wave  path.  For  example  (refer  to  Figure  5-3),  if  the  local  wave 
angle  is  greater  than  6Z  but  less  than  8X  ,  then  cell  i,j+l  is  the  cell  of 
influence  and  ikey  -  i  and  jkey  -  j+1 . 


j-1  j  j+1 


Figure  5-3.  Cells  of  influence  used  in  wave 
breaking  scheme 
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33.  A  flowchart  describing  the  wave  height  computation  is  shown  in 
Figure  5-4.  The  wave  amplitude  function  is  computed  from  the  energy  equation 
assuming  no  dissipation.  The  amplitude  function  is  converted  to  wave  height 
and  compared  with  the  stable  wave  height  yh  .  If  the  wave  is  less  than  or 
equal  to  this  stable  level,  the  wave  has  broken  and  attained  a  stable  height, 
or  it  is  outside  the  surf  zone  and  unbroken.  In  either  case,  no  consideration 
of  dissipation  is  needed.  If  the  wave  height  is  greater  than  yh  ,  the  cell 
of  influence  is  located  and  tested  to  determine  whether  or  not  the  wave  is 
breaking.  If  the  wave  is  breaking  in  the  cell  of  influence,  it  continues  to 
decay  in  height.  If  the  wave  in  the  cell  of  influence  is  not  breaking,  the 
local  wave  height  is  checked  against  the  incipient  breaking  height  criterion. 
If  the  height  exceeds  the  allowable  value,  wave  dissipation  begins.  The 
accuracy  of  the  surf  zone  wave  transformation  model  has  been  verified  using 
laboratory  data  of  Horikawa  and  Kuo  (1966)  and  Izumiya  (1984).  Results  of  the 
comparisons  can  be  found  in  Ebersole,  Cialone,  and  Prater  (1986). 

Computational  stability 

34.  In  applying  RCPWAVE,  it  has  been  determined  that  the  aspect  ratio, 
Ay/Ax  ,  plays  an  important  role  in  determining  the  computational  stability  of 
the  numerical  solution  scheme.  The  maximum  allowable  local  wave  angle  is 
defined  as  the  inverse  tangent  of  the  ratio  Ay/ Ax.  Therefore,  larger  wave 
angles  can  be  resolved  by  the  model  as  this  ratio  increases  (Figure  5-5). 

35.  Computational  instability  occurs  when  no  energy  reaches  a  cell  in 
the  computational  domain,  implying  a  zero  wave  height.  This  instability  may 
occur  when  a  cell  (i,j)  passes  energy  to  cell  (i-I,J+l)  while  cell  ( i,j-l ) 
passes  energy  to  cell  (i-1, j+2)  (Figure  5-6a).  Cell  (i-1, j)  receives  no 
energy  and  therefore  is  assigned  a  zero  wave  height.  The  diffractive  portion 
of  the  model  cannot  recover  from  this  situation.  For  irregular  bathymetry, 
stability  problems  can  occur  when  large  bathymetry  gradients  cause  strong  wave 
refraction  and  local  wave  angles  become  large.  Strongly  oblique  wave  inci¬ 
dence  is  not  a  problem  for  plane  beach  simulations  because  every  cell,  j-1  to 
j-YCELLS ,  in  a  given  row,  i  ,  behaves  identically;  therefore,  energy  is 
uniformly  passed  to  every  cell  in  row  i-1  (Figure  5-6b) . 
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Compute  Wave  Amplitude  Function  a 


Figure  5-4.  Flowchart  of  the  wave  breaking  scheme 
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Figure  5-6.  Schematic  of  wave  energy  passing  from  row  i  to  row  i-i 


PART  III:  DEFINITION  OF  INPUT  DATA  FORMAT 


36.  The  input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  models  released  by  the  USAE  Hydrologic  Engineering 
Center.  It  is  the  intent  that  this  structure,  being  familiar  to  Corps 
personnel,  will  reduce  the  time  needed  to  learn  this  system.  The  general 
format  of  the  input  data  set  records,  where  a  record  refers  to  one  line  of 
data,  is  presented  below: 


a.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

b.  Field  1,  columns  1  through  8,  contains  a  mnemonic  identifica¬ 
tion  label  that  describes  the  purpose  or  function  of  each 
record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right  justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  does  not  need  to  be  right-  or  left- 
justified. 

d.  Array  data,  such  as  depths,  are  read  with  DO  or  Implied  DO 
loops .  No  label  is  required  for  each  record  containing  array 
data.  However,  a  general  specification  record,  such  as  BATHS - 
PEC  which  defines  bathymetric  attributes,  must  precede  that 
array . 


37.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution,  or  bypassing  of  desired 
user-defined  operations,  such  as  bathymetric  changes. 

38.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  simulation  or  required  by  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies  per¬ 
formed  by  Coastal  Engineering  Research  Center  (CERC)  staff.  Although  these 
quantities  may  not  be  applicable  to  all  studies,  they  can  serve  as  a  guide 
when  selecting  replacement  values. 

39.  Default  values  are  processed  when  the  record  field  corresponding  to 
that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving  fields 
blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a  variable 
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being  assigned  a  value  of  zero.  These  variables  and  their  respective  default 
values  are  noted  in  Appendix  5-A.  The  following  discussion  pertains  to  the 
general  format  of  the  input  records  given  in  Appendix  5-A. 

40.  Each  record  is  presented  in  a  standardized  tabular  format  and  has 
as  its  heading  the  mnemonic  identification  label  or  name  with  a  brief  descrip¬ 
tion  of  its  function.  Following  its  name,  the  record  has  an  abbreviated  note 
documenting  whether  it  is  required  for  a  simulation.  These  abbreviations  have 
the  following  definitions: 

(Req)  Record  or  variable  is  required  for  each  simulation. 

(Opt)  Record  or  variable  is  optional.  Omitting  this  item 

results  in  either  the  default  value  being  used  or  the 
defined  operation  not  being  performed. 

For  example,  record  BATHSPEC,  presented  in  Appendix  5-A,  contains  the  note 
(Req)  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt)  meaning  this  record  is 
optional  and  is  only  used  when  changes  to  the  bathymetric  data  are  desired. 

41.  Input  variables,  presented  in  column  2  of  each  table,  are  refer¬ 
enced  to  their  respective  record  fields  shown  in  column  1.  Generally,  data 
for  each  variable  occupy  a  single  8-column  data  field.  However,  variables 
assigned  titling  or  formatting  information  can  occupy  several  fields. 

42.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  column  3  and  can  be  real,  integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up  to  16 

characters 

Char*8  Alphanumeric  character  string  containing  up 

to  8  characters 

Integer  Integer  data 

Real  Real  (floating  point)  data 

43.  Column  4  of  each  table  defines  whether  the  respective  variable  must 
be  assigned  a  value.  Abbreviations  listed  in  this  column  have  identical 
meanings  as  those  for  the  records.  Default  values  are  listed  in  column  5.  A 
blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 
assigned  a  default  value. 
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44.  Column  6  of  each  table  lists  the  variables'  permitted  data  type  or 
all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 
specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+1  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 

45.  Variable  definitions  are  listed  in  table  column  7  of  each  table. 
Variables  whose  quantities  are  unit -dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  WDATUM  is 
assigned  a  value  having  units  defined  by  variable  BUNITS.  Variables  defining 
input  data  units  and  the  record  on  which  they  reside  are  presented  below. 


Variable  Record 

BUNITS  BATHSPEC 

GUNITS  GRIDSPEC 

SUNITS  GENSPECS 


_ P.eilDi£ig.a _ 

bathymetry/topography  data 

numerical  grid  data 

model  computations  and  output 
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Part  IV:  DISCUSSION  OF  THE  INPUT  DATA  REQUIREMENTS 


46.  The  types  of  data  processed  by  RCPWAVE  are  not  extremely  extensive. 
However,  since  each  application  is  unique,  the  type  of  input  data  required  for 
each  study  will  vary.  In  this  discussion  of  model  input,  data  have  been 
divided  into  four  categories  to  present  model  capabilities  and  data  require¬ 
ments.  These  categories  are: 

a.  Model  control  specifications. 

b.  Grid  description. 

c.  Physical  characteristics. 

d.  Output  specifications. 

47.  Table  5-1  presents  RCPWAVE  input  data  records  pertaining  to  each 
category.  A  record  refers  to  one  line  of  data,  and  each  record  begins  with  a 
mnemonic  character  string  to  identify  one  record  type  from  another.  Record 
format  and  detailed  specification  for  each  record  are  presented  in  this 
chapter.  While  reading  Part  IV,  the  user  will  find  it  beneficial  to  refer  to 
Appendix  5-A. 


Model  Control  Parameters 

48 .  The  only  data  record  contained  in  this  category  is  the  GENSPECS 
record.  Record  GENSPECS  is  used  to  specify  the  general  title  of  the  simula¬ 
tion  (TITLE)  and  the  system  of  units  (SUNITS)  used  for  model  computations  and 
displaying  model  results.  Variable  names  are  given  in  parentheses.  Addition¬ 
al  titles  may  be  selected  for  specific  input  data  records.  Although  this 
information  is  optional,  it  can  be  very  helpful  when  reviewing  a  series  of 
simulations.  A  title  should  specifically  state  data  attributes,  such  as  data 
source  or  collection  date,  to  differentiate  from  data  used  in  other 
s imulations . 

'*9.  Model  output  is  displayed  in  either  English  or  metric  units. 
However,  the  user  can  specify  a  different  system  of  units  for  the  input  data. 
For  example,  the  user  can  supply  bathymetry  data  having  units  of  feet  or 
meters.  RCPWAVE  will  convert  the  input  data  into  the  necessary  system  of 
units. 
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Table  5-1 


Input  Data  Set  Records 


Cateeorv 

Record  Name 

Model  control  specifications 

GENSPECS 

Grid  description 

GRIDSPEC 

Physical  characteristics 

BATHSPEC 

CHNGBATH 

WAVCOND 

CONVERG 

Output  specifications 

PRWINDOW 

PLOTREC 

Grid  Description 

50.  The  study  area  is  defined  in  the  model  via  a  computational  grid. 

The  grid  is  composed  of  rectilinear  cells,  where  each  cell  is  assigned  a  two- 
dimensional  index.  The  first  index,  i  ,  corresponds  to  the  x-coordinate ,  and 
the  second  index,  j  ,  corresponds  to  the  y-coori  nat“.  The  grid  index  system 
was  presented  in  Figure  5-1.  All  wave  data,  such  as  >  >.ve  heights,  are 
assigned  and  referenced  to  their  respective  grid  cells  with  this  system. 
Guidelines  for  developing  grids  are  discussed  in  Appendix  A  of  the  CMS  User's 
Manual . 

51.  Selection  of  a  grid  coordinate  system  is  controlled  by  variable 
GRTYPE  on  record  GRIDSPEC.  RCPWAVE  permits  a  rectilinear  uniform  grid 
coordinate  system  only.  A  uniform,  or  constant  grid  cell  size  is  selected  by 
assigning  the  character  string  RECTANG  to  variable  GRTYPE. 

52.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  computational  grid.  Valid  units  are  feet  and  meters.  RCPWAVE  will 
convert  the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 
Variables  XCELLS  and  YCELLS  specify  the  number  of  grid  cells  in  the  x-  and 
y-directions ,  respectively.  Variables  DX  and  DY  on  record  GRIDSPEC  specify 
the  grid's  cell  size  in  the  x-  and  y-directions,  respectively. 
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Physical  Characteristics 


Topography /bathymetry 

53.  Each  grid  cell  must  be  assigned  a  water  depth  or  land  elevation. 
Topography /bathymetry  data  are  referenced  relative  to  an  arbitrary  datum. 
Typically,  the  map  datum  from  which  the  depths  are  taken  it  used.  Water  cells 
are  designated  by  negative  values,  whereas  land  cells  have  positive  values. 

54.  One  BATHSPEC  record  is  required  for  defining  the  general  charac¬ 
teristics  of  the  topography /bathymetry  array  and  must  precede  this  array. 
Variable  BUNITS  defines  the  units  of  topography/bathymetry  data.  Valid  units 
are  feet,  meters,  or  fathoms.  The  input  sequence  for  reading  this  array  is 
controlled  by  variable  BSEQ.  Eight  options  for  the  input  sequence  are 
available  for  reading  the  array  data  and  are  documented  in  Table  5-2.  As  an 
example,  for  the  first  input  sequence  (Figure  5-7),  the  depths  are  read  along 
the  x-direction,  then  y  is  incremented  to  a  value  of  2,  and  again  the  sweep  in 
the  x-direction  takes  place.  This  procedure  is  repeated  until  the  entire 
array  is  read.  The  input  format  for  reading  this  array  can  be  selected  by  the 
user  with  variable  BFORM. 

55.  The  maximum  water  depth  is  specified  with  variable  DLIMIT  and  any 
array  values  deeper  than  DLIMIT  are  set  to  DLIMIT  (in  BUNITS).  Grid-wide 
adjustments  to  land  elevations  contained  in  the  topography /bathymetry  array 
can  be  made  with  variable  LDATUM.  The  value  assigned  to  this  variable  is 
added  to  all  land  cells  in  the  grid.  Positive  LDATUM  values  will  increase 
land  elevations,  whereas  negative  values  will  decrease  land  elevations. 
Similarly,  grid-wide  adjustments  to  water  depths  can  be  made  with  variable 
WDATUM.  The  value  assigned  to  this  variable  is  added  to  all  water  cells. 

Since  these  cells  have  negative  values,  positive  WDATUM  values  produce 
shallower  depths. 

56.  Changes  to  the  topography /bathymetry  array  can  also  be  made  to 
individual  cells  or  a  group  of  cells  with  record  CHNGBATH.  This  record 
allows  the  user  to  quickly  change  values  assigned  to  the  bathymetry  array 
(using  variable  BATH)  without  editing  the  array  itself.  It  should  be  noted 
that  (a)  values  of  the  variable  BATH  on  the  CHNGBATH  record  are  assumed  to 
have  units  consistent  with  those  selected  for  bathymetry/topography  (i.e., 
variable  BUNITS  on  record  BATHSPEC) ,  and  (b)  LDATUM  and  WDATUM  are  not  applied 
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Table  5-2 


Input  Sequence  for  Array  Data 


No 

Sequence 

Description 

1 

XY 

1 

DO  1  J-l , YCELLS 

READ (LUN, FORM)  (VAR(I ,J) , 1-1 .XCELLS) 

2 

-XY 

2 

DO  2  J-l, YCELLS 

READ (LUN .FORM)  (VAR(I , J) , I-XCELLS ,1,-1) 

3 

X-Y 

3 

DO  3  J-YCELLS.l, -1 

READ (LUN, FORM)  (VAR(I ,J) , 1-1 .XCELLS) 

4 

-X-Y 

4 

DO  4  J— YCELLS ,1,-1 

READ (LUN, FORM)  (VAR(I ,J) , I-XCELLS , 1 , -1) 

5 

YX 

5 

DO  5  1-1, XCELLS 

READ (LUN, FORM)  (VAR(I ,J) , J-l .YCELLS) 

6 

-YX 

6 

DO  6  1-1, XCELLS 

READ (LUN, FORM)  (VAR (I , J) , J-YCELLS ,1,-1) 

7 

Y-X 

7 

DO  7  I-XCELLS, 1, -1 

READ (LUN, FORM)  (VAR(I ,J) , J-l .YCELLS) 

8 

-Y-X 

8 

DO  8  I-XCELLS, 1,-1 

READ (LUN, FORM)  (VAR(I.J) , J-YCELLS , 1 , -1) 

to  cells  specified  with  record  CHNGBATH;  therefore,  the  effect  of  nonzero 
LDATUM  and  WDATUM  must  be  included  in  the  value  of  variable  BATH. 

57.  Variables  X1INDX  and  X2INDX  on  the  CHNGBATH  record  specify  the 
minimum  and  maximum  cell  numbers  in  the  x-direction,  respectively,  where  the 
topography /ba thyme try  value  will  change.  Similarly,  variables  Y1INDX  and 
Y2INDX  on  the  CHNGBATH  record  specify  the  minimum  and  maximum  cell  numbers  in 
the  y-direction,  respectively,  where  the  topography /bathymetry  value  will 
change.  More  than  one  CHNGBATH  record  is  permitted. 

Wave  conditions 

58.  Each  simulation  requires  wave  information  in  deep  water  (i.e.,  the 
deepwater  wave  height,  direction,  and  period).  The  angle  which  the  offshore 
contour  makes  with  the  grid  y-axis  is  also  needed  (see  Figure  5-4  for  the 
angle  definition/sign  convention) . 

59.  A  WAVCOND  record  is  required  to  define  each  of  the  deepwater  wave 
conditions  to  be  simulated.  One  WAVCOND  record  is  required  for  each  wave 
condition  to  be  simulated,  and  multiple  wave  conditions  are  permitted  for  a 
single  simulation.  Simulations  are  usually  limited,  however,  to  5  to  10  wave 
conditions  grouped  together  in  a  logical  manner.  Diffractive  effects  can  be 
included  or  excluded  for  any  given  simulation  by  specification  on  the  WAVCOND 
record. 

60.  Variables  HDEEP,  TDEEP,  and  ZDEEP  specify  the  deepwater  wave 
height,  period,  and  deepwater  wave  angle,  respectively.  Variable  CNTRNG  is 
used  to  define  the  offshore  contour  angle.  The  inclusion  of  topography- 
induced  diffractive  effects  is  accomplished  by  setting  DIFFR  equal  to  YES . 
Convergence  criteria 

61.  Certain  model  parameters  can  be  modified  to  alter  how  quickly  the 
model  converges  toward  a  solution  to  the  governing  equations.  When  the  change 
in  a  given  variable  from  iteration  to  iteration  is  less  than  a  specified 
value,  the  model  has  "converged"  on  a  solution.  The  change  in  the  variable 
from  iteration  to  iteration  is  called  the  convergence  criterion.  Variables 
HCONVR  and  SCONVR  on  record  CONVERG  are  convergence  criteria  for  wave  heights 
and  wave  angles,  respectively.  ITAMX  and  IDIFF  are  the  maximum  number  of 
iterations  for  wave  heights/angles  and  diffraction  computations,  respectively. 
Default  values  for  the  convergence  criteria  have  been  developed  based  on 
experience.  Users  should  not  change  these  values  arbitrarily. 
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62.  Certain  model  parameters  are  used  to  specify  the  stable  wave  height 
und  rate  of  wave  height  decay  through  the  surf  zone.  Variables  STABL  and 
DECAY  on  record  CONVERG  are  used  to  set  the  stability  and  decay  coefficients 
used  in  surf  zone  computations.  For  more  information  on  the  selection  of 
these  values,  refer  to  Dally,  Dean,  and  Dalrymple  (1984). 

Output  Specifications 

63.  RCPWAVE  generates  an  output  listing  containing  a  summary  of  the 
input  data  set  for  every  simulation.  Error  and  warning  diagnostic  messages 
are  also  contained  in  this  listing.  A  sample  output  listing  containing  a 
summary  of  the  input  dataset  is  presented  in  Figure  5-8. 


-  PLATE  BEACH  EKWT.E  - 

FILES  CASE:  SPECIFICATION  OF  PERMANENT  FILE  HANES  FOR  DATA  STORAGE /RETRIEVAL 
VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  VAR  I  ARE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 

FtfFSNT  FILE  FOR  PRINTED  BJTPIT  CHSFRKT  • 


«•«*«  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GETCRAL  SYSIEH  OF  UNITS 

VARIABLE  DESCRIPTION  OF  U5AGE:  VALUE:  NOTES:  •  VAR  I  ARE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 

SUNITS  UNITS  SYSTEM  USED  IN  OTfUTATlONS  ENGLISH  • 


GRIDSPEC  CARD:  SPECIFICATION  OF  TIE  TYPE  OF  FINITE -DIFFERENCE  GRID  USED 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

MIES;  *  VARIABLE 

DESCRIPTION  OF  USAGE: 

GRTYPE 

I  CELL 

OX 

TYPE  OF  FINITE-DIFFERENCE  GRID 
TUCER  OF  GRID  CEILS.  1  DIRECTION 
SPATIAL  STEPSIZE  IN  1  DIRECTION 

RECTANG 

48 

10.00 

•  GUNITS 

•  YCELL 

•  DY 

SYSTEN  OF  UNITS  USED  FOR  THE  GRID 
NUMBER  OF  GRID  CEILS.  T  DIRECTION 
SPATIAL  STEPSIZE  IN  Y  DIRECTIIW 

VALUE:  MIES: 


ENGLISH 

5 

10.00 


PRINTIN6  OF  FIELD  ARRAY  VARIABLES:  I  AREAS 

t  •  VARIABLE  FIELD 

«  START  AT  EMI  AT  INTERVAL  WTES:  •  ARRAYS  TO  PRINT:  NOTES: 
•  -  - - • - - 

t  •  DM8 


«MM  KAVOT©  CATO:  NUTCEP  CF  W*X  COPOITIONS:  1 


AREA  •  START  I  MB  DOING 
HJWER  *  X  CELL  X  CELL 

1  •  X*  1  X=  48 


STARTING  ENDING 
Y  CELL  Y  CELL  NOTES: 


Y«  1  Y*  5 


Nft£  CONDITION  NUMBER:  1 


VARIABLE 

DESCRIPTION  OF  USAGE: 

value:  nous 

:  •  VARIABLE  DESCRIPTION  IF  USAS: 

VALUE:  MTES: 

WEEP 

CFEPNATER  NAVE  TEIWT 

1.00 

•  TDEEP 

NAVE  PER  IX 

B.00 

ZOEEP 

KZPHATER  NAVE  ANGLE 

0.00 

•  DIFFR 

DIFERACTKM  SITUATED 

YES 

CNTRANG 

OFTSWRE  C0NT0UT  AWE 

0.00 

• 

I  06/13/91 

COASTAL  H0DELINS 

SYSTEM 

(CHS): 

RCPNAV.  VERSION  1 

1  .  0  11:02:33 

Figure  5-8.  Sample  output  listing 
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64.  Each  record  is  summarized  in  tabular  form  with  a  heading  containing 
its  record  identification  label  followed  by  a  brief  description  of  that 
record's  function.  A  table  is  composed  of  each  variable's  name,  a  description 
of  that  variable  (including  its  units,  when  applicable),  and  an  error  diagnos¬ 
tic  note. 

65.  RCPWAVE  contains  error  diagnostic  features  that  inspect  an  input 
data  set  for  possible  errors.  These  features  include:  (a)  comparing  an 
inputted  value  against  a  range  of  quantities  that  are  representative  for  that 
variable,  (b)  checking  for  misspelled  character  data,  and  (c)  checking  for 
missing  data.  The  error  diagnostic  note  can  be  assigned  one  of  three  charac¬ 
ter  strings,  which  are  (a)  "FATAL"  for  errors  where  the  model  cannot  execute 
given  the  value  supplied,  (b)  "WARN"  for  data  that  are  out  ide  the  range  of 
values  typically  selected  for  that  variable,  and  (c)  a  null  string  for 
instances  where  an  error  condition  has  not  been  identified.  Although  this 
model  contains  error  diagnostic  capabilities,  the  user  should  thoroughly 
inspect  the  input  data  summary  to  ensure  that  the  data  are  correct. 

66.  Field  arrays  (e.g.,  bathymetry,  wave  heights,  angle,  numbers, 
breaker  indices)  are  printed  along  with  the  input  data  summary  by  including 
one  or  more  PRWINDOW  records .  Variable  WPRVAR  on  record  PRWINDOW  is  used  to 
specify  which  field  arrays  are  to  be  printed  (e.g.  WPRVAR  -  B  for  breaker 
indices).  The  breaker  index  is  a  flag  to  distinguish  cells  where  wave 
breaking  occurs  (indicated  with  a  B) ,  from  cells  where  wave  breaking  does  not 
occur  (indicated  with  a  .).  The  user  can  specify  printing  of  subgrid  regions 
as  opposed  to  the  entire  grid,  if  they  so  choose.  This  is  done  by  specifying 
the  x-  and  y-boundaries  of  a  subgrid  region  with  variables  WXCEL1 ,  WXCEL2, 
WYCEL1,  and  WYCEL2 . 

67.  Plotting  wave  rays  is  facilitated  by  adding  a  PLOTREC  record  to  the 
input  data  set.  With  this  record,  wave  angles  are  saved  for  every  grid  cell 
in  the  computational  domain  for  any  number  of  wave  conditions.  The  wave  angle 
data  is  then  used  by  program  RAYPLOT  in  CMSPOST  to  generate  wave  ray  plots. 
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FART  V:  ILLUSTRATIVE  EXAMPLES 


68.  Two  examples  are  included  in  this  section  to  demonstrate  RCPWAVE's 
capabilities.  The  model  was  used  to  simulate  wave  conditions  at  the  CERC's 
Field  Research  Facility  (FRF)  in  Duck,  North  Carolina,  and  at  Homer  Spit, 
Alaska. 


Duck.  North  Carolina 

69.  The  FRF  is  located  on  the  northern  North  Carolina  coast.  The 
selected  study  area  measured  900  m  in  the  x-  (on-offshore)  direction  and 

l, 200  m  in  the  y-  (longshore)  direction.  The  grid  was  composed  of  75  cells  in 
the  x-direction  and  50  cells  in  the  y-direction,  with  a  cell  size  of  12  by  24 

m,  respectively.  Bathymetry  contours  off  the  Duck,  North  Carolina,  coast  are 

generally  straight  and  parallel  to  the  coastline,  except  in  the  immediate 
vicinity  of  the  FRF  pier  (Figure  5-9).  The  pier's  presence  has  caused  the 
formation  of  a  deep  scour  hole  along  much  of  its  length.  Actual  depth  values 
(relative  to  mean  sea  level  (msl))  were  provided  for  each  cell  in  the  study 
grid.  The  total  water  depth  matrix  was  computed  by  simply  adding  half  of  the 
mean  tide  range  (0.5  m)  to  each  depth  value.  Two  wave  conditions  were  consid¬ 
ered:  (a)  Ha  -  2  m,  T  -  12  sec,  and  80  -  20  deg  and  (b)  H0  -  1.5  m,  T  - 

8  sec,  and  80  -  -35  deg.  The  input  data  set  is  given  in  Appendix  5-B  for 
details  of  each  record. 


Figure  5-9.  Bathymetric  contours  at 
Duck,  North  Carolina 
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70.  A  wave  ray  plot  for  each  of  the  two  wave  conditions  is  given  in 
Figures  5-10  and  5-11  for  the  entire  computational  domain.  The  wave  rays  tend 
to  diverge  from  the  scour  hole  along  the  pier  and  converge  on  the  adjacent 
shoals,  as  expected.  Model  results  (wave  angles,  heights,  and  breaker  indices 
only)  were  also  printed  (Table  5-3)  for  the  subgrid  region  shown  in  Figure  5- 
9.  The  breaker  indices  show  wave  breaking  on  the  shoals  and  farther  shoreward 
in  the  vicinity  of  the  pier. 


Figure  5-10.  Wave  rays  for  wave  condition  1 
at  Duck,  North  Carolina 
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Figure  5-11.  Wave  rays  for  wave  condition  2  at  Duck,  North  Carolina 
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Table  5-3 

Output  Summary  for  Duck.  North  Carolina.  Simulation 


COfiSiAL  lUtELlKG  SYSTEM  i  C  rt  S  i  :  R  C  P  *1  A  V  ,  VERSION  i.O 

-  FIELD  RESEARCH  FACILITY  (ttJCK,  NC)  EXAIPLE  - 


t».».  GENSPECS  card:  SPECIFICATION  OF  TITLE  AND  GEICRAL  SYSTEM  OF  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  VARIABLE  DESTOIPTION  OF  USAGE:  VALUE:  NOTES: 

SUNITS  UNITS  SYSTEM  USED  IN  CWFUTATIONS  ICTRIC  • 


*•*•»  GRIDSPEE  OWD:  SPECIFICATION  OF  T>£  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

6RTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

XCELL 

NUMBER  OF  GRID  CELLS.  X  DIRECTION 

75 

DX 

SPATIAL  STEPSI7E  IN  X  DIRECTION 

12.00 

•  VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 


*  SUNITS  SYSTEM  OF  (MTS  USED  FOR  THE  GRID  (CTRIC 

*  YCELL  NUMBER  OF  GRID  CELLS.  Y  DIRECTION  SO 

*  DY  SPATIAL  STEPSI7E  IN  Y  DIRECTION  24.00 


«♦•*«  PRINTING  OF  FIELD  ARRAY  VARIABLES:  I  AREAS 


AREA  • 

STARTING 

ENDING 

STARTING 

END1NS 

$  1 

VARIABLE  FIELD 

NUWER  * 

X  OIL 

X  CELL 

Y  CELL 

Y  CELL  NOTES: 

*  START  AT  EM)  AT  INTERVAL  NOTES:  » 

ARRAYS  TO  PRINT:  NOTES: 

1  « 

X=  1 

X=  50 

Y*  11 

V*  41 

$  $ 

DAW 

*****  mvcoND  am:  mjhber  of  nave  caamats:  2 
BREAKING  IWEX 


1=  13  14 


IS  16  17  18 


19  20  21  22  23  24 


3=  41  B 

3=  40  B 

3=  39  B 

3=  38  B 

3=  37  B 

3=  36  B  B 

3=  35  B  B 

3=  34  B  B 

3=  33  B  B 

3=  32  B  B 

3=  31  B  B 

3=  30  B  B 

3=  29  B  B 

3=  28  B  B 

3=  27  B  B 

3=  26  B  B 

3=  25  B  B 

3=  24  B  B 

3=  23  B  B 

3=  22  B  B 

3=  21  B 

3=  20  B  B 

3=  19  B  B 


B 

B 

B 

B 


B 
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71.  Homer  Spit  is  a  narrow  peninsula  300  to  1,500  feet  wide,  extending 
approximately  4-1/2  miles  from  northwest  to  southeast  into  Kachemak  Bay,  an 
appendage  of  lower  Cook  Inlet  in  southcentral  Alaska  (Figure  5-12).  The 
selected  study  area  measured  7.5  miles  in  the  x-  (on-offshore)  direction  and 
13  miles  in  the  y-  (longshore)  direction.  The  grid  was  composed  of  96  cells 
in  the  x-direction  and  83  cells  in  the  y-direction,  with  a  cell  size  of 
416.7  by  833.3  ft.  Bathymetry  in  the  vicinity  of  Homer  Spit  is  complicated 
(Figure  5-13).  Actual  depth  values  (relative  to  mean  lower  low  water  (mllw)) 
were  provided  for  each  cell  in  the  study  grid.  One  wave  condition  was 
considered:  Ha  -  8  ft,  T  -  10  sec,  and  60  -  -45  deg.  The  input  data  set  is 
given  in  Appendix  5-C  for  details  of  each  record. 


i  wot  ttrjp  isroo* 


Figure  5-12.  Map  of  Homer  Spit,  Alaska 


Y-  AXIS 


Figure  5-13.  Bathymetric  contours  at  Homer  Spit,  Alaska 


72.  A 
entire  grid, 
results  (wave 
for  cells  1=1 


wave  ray  plot  of  model  results  is  given  in  Figure  5- 
The  wave  rays  bend  towards  the  shoals,  as  expected, 
heights,  angles,  numbers,  and  breaker  indices)  were 
to  1=50  and  J=25  to  J=55  (Table  5-4). 


14  for  the 
Model 

also  printed 
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Figure  5-14.  Wave  rays  for  wave  condition  1 
at  Homer  Spit,  Alaska 
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Table  5-4 

Output  Summary  for  Homer  Spit.  Alaska.  Simulation 

NOtEliti  S  Y  S  1  E  f.  !  i  n  S  )  :  R  C  F  «  h  V  .  VERSION  1.0 

-  HOMES  SPIT.  ALASKA  EXAMPLE  - 


•«**  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  VARIABLE  DESCRIPTION  OF  USAW:  VALUE:  NOTES: 


SUNITS  UNITS  SYSTEM  USED  IN  COMPUTATIONS  ENGLISH 


•mm  GRIDSPEC  CARO:  SPECIFICATION  OF  T)C  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 


VARIABLE 

DESCRIPTION  OP  USAGE: 

VALUE:  NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

GRTYPE 

XCELL 

OX 

TYPE  OF  FINITE-DIFFERENCE  GRID 
NUMBER  OF  GRID  CELLS.  X  DIRECTION 
SPATIAL  STEPSIZE  IN  X  DIRECTION 

RECTAN6 

96 

416.70 

•  6UNITS 

•  YCELL 

•  DY 

SYSTEM  OF  WITS  USED  FOR  TIE  GRID 
NUMBER  OF  GRID  CELLS,  Y  DIRECTION 
SPATIAL  STEPSIZE  IN  Y  DIRECTION 

ENGLISH 

63 

833.30 

•mm  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA  « 

STARTING 

ENDING 

STARTING 

ENDING 

* 

• 

VARIABLE  FIELD 

NUMBER  • 

X  CELL 

X  CEIL 

Y  CELL 

Y  CELL  NOTES: 

♦  START  AT  END  AT 

INTERVAL  NOTES:  * 

ARRAYS  TO  PRINT:  NOTES: 

1  • 

X=  1 

X=  96 

Y=  1 

Y=  83 

• 

t 

DAW 

*•••*  MAVCOND  CARD:  NUMBER  OF  HAVE  CONDITIONS:  1 


HAVE 

CONDITION  NUMBER:  1 

VARIABLE 

DESCRIPTION  DF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTIW  OF  USAGE: 

VALUE: 

NOTES: 

WEEP 

DEEPHATER  NAVE  WIGHT 

8.00 

•  TDEEP 

NAVE  PERIOD 

10.00 

ZDEEP 

OEEPHATER  HAVE  ANGLE 

-45.00 

•  DIFFR 

DIFFRACTJW  SIMULATED 

YES 

CNTRANG 

OFFSHORE  CONTOUR  ANGLE 

0.00 

• 

COASTAL  MODELING 

SYSTEM  (CHS) 

:  R  C  P  N 

AV,  VERSION  1.0 

••»»  BATHSPEC  CARD:  SPECIFICATION  OF  BATHYWTHY /TOPOGRAPHY  - 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

«  VARIABLE 

DESCRIPTIW  OF  USAGE: 

VALUE: 

NOTES: 

RJNITS 

SYSTEM  OF  WITS  FOR  DEPTH  DATA  FEET 

*  BSEO 

READ  SEQUENCE  FOR  DEPTH  DECK 

YX 

NDA1UM 

DATUM  FOR  HATER  DEPTHS 

0.000 

•  LDATUN 

DATUM  FOR  LAND  ELEVATIONS 

0.000 

OLINIT 

MAXIMW  DEPTH  ALLONEB 

-6000.0 

•  BFORN 

FORMAT  OF  DEPTH  DATA 

(1QFB.0) 

NUMBER  OF  ELEVATION  CHANGES 

=  0 

•»•  IWUT  PROCESSING  COWLETED: 

FATAL  ERRORS1  0  HARNINGS  =  0 
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APPENDIX  5 -A:  RCPWAVE  DATA  SPECIFICATION  RECORDS 
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Model  Control  Specifications 


(Req) 

GENSPECS 

Specify  general  title  and  system  of  units 

Grid  Descriotion 

(Req) 

GRIDSPEC 

Specify  general  grid  characteristics 

Physical  Characteristics 

(Req) 

BATHSPEC 

Specify  characteristics  of  bathymetry/topography 

(Req) 

Two-dimensional  array  of  bathymetric/topo¬ 
graphic  data 

(Opt) 

CHNGBATH 

Specify  changes  to  the  bathymetric  data 

(Req) 

WAVCOND 

Specify  deepwater  wave  conditions 

(Opt) 

CONVERG 

Specify  changes  to  the  convergence  criteria 

OutDut  Soecifications 

(Req) 

PRWINDOW 

Specify  location  of  a  print  window 

(Opt) 

PLOTREC 

Specify  saving  data  for  wave  ray  plot 
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9-10  BNAME  Char  *16  (Opt)  A*  Name  of  bathymetry/topography  set. 
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APPENDIX  5-B: 


INPUT  DATA  SET  FOR  DUCK,  NORTH  CAROLINA 
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GENSPECS  FIELD  RESEARCH  FACILITY  (DUCK,  NC)  EXAMPLE 

METRIC 


GRIDSPEC 

METRIC 

75 

50 

12.0 

24.0 

PRWINDOW 

1 

50 

11 

41 

DAHB 

BATHSPEC 

METERS 

0.5 

XY 

(9F8.2) 

5.76 

6.05 

3.13 

2.59 

1.18 

-.13 

-1.62 

-1.90 

-1.03 

-.92 

-1.20 

-1.44 

-1.86 

-2.29 

-2.78 

-3.08 

-3.54 

-3.83 

-4.02 

-4.08 

-4.05 

-3.99 

-3.88 

-3.81 

-3.69 

-3.67 

-3.69 

-3.75 

-3.84 

-3.93 

-4.05 

-4.22 

-4.33 

-4.45 

-4.53 

-4.69 

-4.76 

-4.94 

-5.03 

-5.12 

-5.24 

-5.37 

-5.51 

-5.64 

-5.72 

-5.82 

-5.92 

-5.97 

-6.10 

-6.22 

-6.28 

-6.40 

-6.52 

-6.60 

-6.70 

-6.74 

-6.80 

-6.88 

-6.96 

-7.01 

-7.04 

-7.16 

-7.28 

-7.31 

-7.36 

-7.41 

-7.56 

-7.62 

-7.68 

-7.74 

-7.86 

-7.92 

-8.07 

-8.14 

-8.19 

5.61 

4.95 

3.49 

2.23 

1.06 

-.23 

-1.22 

-1.55 

-1.34 

-1.14 

-1.24 

-1.53 

-1.83 

-2.38 

-2.87 

-3.23 

-3.53 

-3.83 

-4.05 

-4.11 

-4.08 

-4.00 

-3.89 

-3.80 

-3.72 

-3.68 

-3.70 

-3.75 

-3.83 

-3.92 

-4.07 

-4.23 

-4.34 

-4.43 

-4.53 

-4.65 

-4.78 

-4.92 

-5.01 

-5.11 

-5.22 

-5.35 

-5.49 

-5.61 

-5.69 

-5.78 

-5.90 

-5.99 

-6.07 

-6.16 

-6.28 

-6.39 

-6.48 

-6.58 

-6.67 

-6.74 

-6.80 

-6.88 

-6.94 

-6.99 

-7.05 

-7.15 

-7.25 

-7.30 

-7.34 

-7.43 

-7.53 

-7.61 

-7.67 

-7.74 

-7.84 

-7.93 

-8.03 

-8.09 

-8.14 

5.45 

4.77 

3.65 

2.27 

1.14 

-.13 

-1.02 

-1.38 

-1.43 

-1.36 

-1.40 

-1.61 

-1.89 

-2.47 

-3.01 

-3.37 

-3.67 

-3.94 

-4.15 

-4.20 

-4.17 

-4.06 

-3.91 

-3.81 

-3.74 

-3.70 

-3.71 

-3.75 

-3.83 

-3.91 

-4.05 

-4.20 

-4.31 

-4.40 

-4.51 

-4.62 

-4.75 

-4.87 

-4.97 

-5.09 

-5.18 

-5.28 

-5.42 

-5.53 

-5.62 

-5.72 

-5.85 

-5.94 

-6.03 

-6.12 

-6.24 

-6.36 

-6.44 

-6.55 

-6.62 

-6.72 

-6.78 

-6.86 

-6.91 

-6.96 

-7.02 

-7.13 

-7.21 

-7.26 

-7.30 

-7.40 

-7.50 

-7.59 

-7.65 

-7.71 

-7.81 

-7.89 

-7.98 

-8.01 

-8.06 

5.66 

4.90 

3.67 

2.44 

1.32 

-.00 

-.91 

-1.30 

-1.50 

-1.55 

-1.56 

-1.66 

-1.94 

-2.55 

-3.10 

-3.50 

-3.83 

-4.08 

-4.25 

-4.29 

-4.27 

-4.17 

-3.95 

-3.84 

-3.76 

-3.71 

-3.70 

-3.74 

-3.82 

-3.89 

-4.02 

-4.15 

-4.27 

-4.36 

-4.47 

-4.58 

-4.69 

-4.79 

-4.90 

-5.05 

-5.14 

-5.23 

-5.35 

-5.46 

-5.56 

-5.67 

-5.78 

-5.88 

-6.00 

-6.10 

-6.21 

-6.31 

-6.40 

-6.51 

-6.59 

-6.69 

-6.75 

-6.84 

-6.88 

-6.93 

-6.99 

-7.11 

-7.17 

-7.22 

-7.26 

-7.37 

-7.47 

-7.56 

-7.63 

-7.70 

-7.78 

-7.84 

-7.91 

-7.95 

-7.99 

6.39 

5.24 

3.49 

2.59 

1.52 

.02 

-.91 

-1.30 

-1.55 

-1.68 

-1.66 

-1.59 

-1.92 

-2.59 

-3.13 

-3.57 

-3.93 

-4.16 

-4.32 

-4.35 

-4.33 

-4.25 

-4.02 

-3.84 

-3.77 

-3.69 

-3.67 

-3.73 

-3.79 

-3.88 

-3.98 

-4.12 

-4.23 

-4.34 

-4.43 

-4.55 

-4.64 

-4.73 

-4.86 

-5.01 

-5.11 

-5.20 

-5.32 

-5.44 

-5.55 

-5.65 

-5.75 

-5.85 

-5.98 

-6.07 

-6.20 

-6.29 

-6.38 

-6.49 

-6.58 

-6.66 

-6.76 

-6.82 

-6.87 

-6.91 

-6.98 

-7.08 

-7.16 

-7.19 

-7.24 

-7.35 

-7.46 

-7.53 

-7.62 

-7.70 

-7.77 

-7.81 

-7.87 

-7.93 

-7.98 

6.37 

5.24 

3.51 

2.60 

1.54 

.06 

-  .88 

-1.28 

-1.54 

-1.69 

-1.67 

-1.60 

-1.94 

-2.60 

-3.14 

-3.58 

-3.95 

-4.17 

-4.33 

-4.36 

-4.33 

-4.24 

-4.00 

-3.83 

-3.76 

-3.68 

-3.67 

-3.72 

-3.79 

-3.88 

-3.97 

-4.11 

-4.23 

-4.33 

-4.42 

-4.53 

5-50 


-4.63 

-4.71 

-4.84 

-4.99 

-5.09 

-5.20 

-5.31 

-5.43 

-5.53 

-5.64 

-5.74 

-5.84 

-5.98 

-6.07 

-6.20 

-6.28 

-6.38 

-6.49 

-6.59 

-6.67 

-6.76 

-6.83 

-6.88 

-6.92 

-6.99 

-7.09 

-7.16 

-7.25 

-7.36 

-7.47 

-7.54 

-7.63 

-7.70 

-7.77 

-7.81 

-7.87 

-7.93 

-7.97 

5.78 

4.97 

3.70 

2.55 

1.44 

.18 

-.74 

-1.18 

-1.46 

-1.59 

-1.62 

-1.68 

-2.01 

-2.61 

-3.18 

-3.59 

-3.97 

-4.18 

-4.32 

-4.34 

-4.30 

-4.15 

-3.91 

-3.78 

-3.72 

-3.67 

-3.66 

-3.72 

-3.80 

-3.87 

-3.97 

-4.10 

-4.22 

-4.31 

-4.39 

-4.50 

-4.59 

-4.69 

-4.80 

-4.95 

-5.05 

-5.18 

-5.29 

-5.40 

-5.51 

-5.62 

-5.72 

-5.84 

-5.98 

-6.09 

-6.18 

-6.29 

-6.39 

-6.52 

-6.60 

-6.73 

-6.79 

-6.88 

-6.93 

-6.98 

-7.05 

-7.16 

-7.21 

-7.27 

-7.30 

-7.41 

-7.50 

-7.59 

-7.66 

-7.72 

-7.81 

-7.86 

-7.92 

-7.95 

-7.98 

5.77 

4.93 

3.73 

2.53 

1.43 

.28 

-  .58 

-1.06 

-1.35 

-1.48 

-1.55 

-1.65 

-2.05 

-2.64 

-3.23 

-3.61 

-4.02 

-4.22 

-4.35 

-4.35 

-4.25 

-4.06 

-3.83 

-3.68 

-3.65 

-3.62 

-3.63 

-3.69 

-3.78 

-3.86 

-3.94 

-4.06 

-4.20 

-4.28 

-4.34 

-4.44 

-4.53 

-4.65 

-4.77 

-4.89 

-4.99 

-5.12 

-5.25 

-5.38 

-5.48 

-5.59 

-5.70 

-5.83 

-5.99 

-6.09 

-6.18 

-6.30 

-6.42 

-6.58 

-6.66 

-6.81 

-6.86 

-6.96 

-7.03 

-7.09 

-7.14 

-7.25 

-7.32 

-7.37 

-7.40 

-7.51 

-7.59 

-7.67 

-7.72 

-7.78 

-7.88 

-7.93 

-8.00 

-8.02 

-8.04 

5.98 

5.08 

3.61 

2.55 

1.46 

.26 

-.56 

-1.03 

-1.34 

-1.49 

-1.57 

-1.66 

-2.04 

-2.68 

-3.23 

-3.64 

-4.04 

-4.28 

-4.39 

-4.34 

-4.18 

-3.98 

-3.76 

-3.61 

-3.58 

-3.57 

-3.59 

-3.66 

-3.76 

-3.86 

-3.92 

-4.04 

-4.17 

-4.25 

-4.32 

-4.40 

-4.49 

-4.63 

-4.75 

-4.86 

-4.96 

-5.09 

-5.23 

-5.36 

-5.48 

-5.60 

-5.71 

-5.87 

-6.02 

-6.12 

-6.22 

-6.34 

-6.47 

-6.63 

^B 

-6.88 

-6.95 

-7.05 

-7.13 

-7.19 

-7.23 

-7.34 

-7.43 

-7.46 

-7.51 

-7.60 

-7.69 

-7.76 

-7.80 

-7.86 

-7.94 

-8.02 

-8.08 

-8.09 

-8.11 

6.33 

6.84 

3.41 

2.69 

1.98 

.37 

-.77 

-.88 

-1.23 

-1.35 

-1.47 

-1.45 

-1.89 

-2.73 

-3.26 

-3.58 

-3.94 

-4.36 

-4.42 

-4.45 

-4.32 

-4.02 

-3.76 

-3.60 

-3.57 

-3.54 

-3.58 

-3.63 

-3.74 

-3.84 

-3.93 

-3.99 

-4.15 

-4.22 

-4.30 

-4.39 

-4.48 

-4.60 

-4.69 

-4.82 

-4.94 

-5.09 

-5.21 

-5.33 

-5.46 

-5.58 

-5.70 

-5.84 

-5.97 

-6.07 

-6.22 

-6.31 

-6.43 

-6.64 

-6.80 

-6.89 

-6.95 

-7.07 

-7.17 

-7.20 

-7.23 

-7.34 

-7.46 

-7.50 

-7.55 

-7.60 

-7.74 

-7.80 

-7.84 

-7.89 

-7.93 

-8.08 

-8.10 

-8.13 

-8.14 

5.91 

5.00 

3.56 

2.42 

1.28 

.12 

-.71 

-1.24 

-1.54 

-1.71 

-1.77 

-1.79 

-2.04 

-2.62 

-3.21 

-3.60 

-4.01 

-4.27 

-4.35 

-4.24 

-4.00 

-3.79 

-3.62 

-3.53 

-3.53 

-3.55 

-3.59 

-3.67 

-3.78 

-3.88 

-3.95 

-4.05 

-4.18 

-4.27 

-4.35 

-4.42 

-4.52 

-4.66 

-4.80 

-4.90 

-5.00 

-5.15 

-5.28 

-5.42 

-5.54 

-5.67 

-5.80 

-5.97 

-6.12 

-6.23 

-6.34 

-6.46 

-6.58 

-6.72 

-6.84 

-6.96 

-7.03 

-7.14 

-7.21 

-7.26 

-7.30 

-7.39 

-7.48 

-7.53 

-7.58 

-7.66 

-7.74 

-7.81 

-7.86 

-7.91 

-7.98 

-8.05 

-8.11 

-8.13 

-8.16 

6.24 

5.76 

3.36 

2.47 

1.05 

.08 

-1.12 

-1.52 

-1.83 

-2.03 

-2.21 

-1.89 

-1.83 

-2.59 

-3.19 

-3.65 

-4.05 

-4.37 

-4.46 

-4.19 

-3.89 

-3.63 

-3.49 

-3.46 

-3.49 

-3.54 

-3.62 

-3.68 

-3.80 

-3.93 

-4.00 

-4.08 

-4.19 

-4.29 

-4.38 

-4.46 

V 

5-51 

-4. 

54 

-4.69 

-4.84 

-4.89 

-5.03 

-5.19 

-5.31 

-5.47 

-5. 

58 

-5. 

73 

-5.88 

-6.03 

-6.19 

-6.33 
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-3.93 

-3.72 

-4.72 

-5.70 

-6.57 

-7.32 

-7.92 

-1.28 

-3.88 

-3.72 

-4.73 


5-57 


-4.81 

-4.93 

-5.08 

-5.20 

-5.80 

-5.89 

-5.99 

-6.09 

-6.59 

-6.67 

-6.75 

-6.88 

-7.37 

-7.44 

-7.54 

-7.63 

-7.95 

-7.97 

-8.00 

5.52 

4.40 

2.91 

1.48 

-1.22 

-1.36 

-1.59 

-1.92 

-3.89 

-3.86 

-3.80 

-3.74 

-3.81 

-3.95 

-4.03 

-4.12 

-4.81 

-4.92 

-5.07 

-5.19 

-5.78 

-5.89 

-5.99 

-6.09 

-6.54 

-6.61 

-6.69 

-6.83 

-7.35 

-7.41 

-7.52 

-7.60 

-7.90 

-7.93 

-7.96 

5.85 

4.97 

3.06 

1.67 

-1.17 

-1.30 

-1.50 

-1.95 

-3.91 

-3.87 

-3.81 

-3.75 

-3.79 

-3.93 

-4.02 

-4.11 

-4.80 

-4.93 

-5.05 

-5.18 

-5.80 

-5.89 

-6.00 

-6.11 

-6.53 

-6.56 

-6.67 

-6.81 

-7.35 

-7.41 

-7.50 

-7.59 

-7.88 

-7.92 

-7.95 

WAVCOND 

2.00 

12.0 

20.00 

WAVCOND 

1.50 

8.0 

-35.00 

PLOTREC 

-5.28 

-5.38 

-5.50 

-5.60 

-5.68 

-6.21 

-6.29 

•6.36 

-6.44 

-6.52 

-6.98 

-7.05 

-7.14 

-7.22 

-7.31 

-7.69 

-7.73 

-7.77 

-7.81 

-7.88 

.14 

-.70 

-.99 

-1.05 

-1.12 

-2.55 

-3.22 

-3.55 

-3.75 

-3.86 

-3.68 

-3.63 

-3.63 

-3.67 

-3.71 

-4.27 

-4.39 

-4.47 

-4.58 

-4.72 

-5.27 

-5.39 

-5.50 

-5.60 

-5.68 

-6.19 

-6.28 

-6.36 

-6.42 

-6.49 

-6.94 

-7.02 

-7.11 

-7.20 

-7.29 

-7.64 

-7.68 

-7.71 

-7.76 

-7.83 

.27 

-.79 

-.89 

-.87 

-1.05 

-2.57 

-3.19 

-3.55 

-3.76 

-3.86 

-3.67 

-3.61 

-3.63 

-3.67 

-3.72 

-4.26 

-4.37 

-4.46 

-4.59 

-4.69 

-5.26 

-5.39 

-5.51 

-5.60 

-5.69 

-6.19 

-6.28 

-6.36 

-6.41 

-6.48 

-6.94 

-7.00 

-7.08 

-7.19 

-7.28 

-7.62 

-7.65 

-7.67 

-7.74 

-7.80 

5-58 


GENSPECS  HOMER  SPIT,  ALASKA  EXAMPLE  ENGLISH 


GRIDSPEC 

ENGLISH 

96 

83 

416.7 

833.3 

WAVCOND 

8.00 

10.0 

-45.00 

PRWINDOW 

1 

96 

1 

83 

DAHB 

BATHSPEC 

FEET 

YX 

(10F8.2) 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

o.oo 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

o.oc 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0  00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.0° 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

o.oc 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0  00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0  00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

5-60 


0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

Wr  o.oo 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

-0.18 

-0.36 

-0.66 

-0.90 

-1.38 

-2.04 

-1.92 

-1.02 

-0.78 

-1.08 

-1.20 

-1.20 

-0.78 

-0.30 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

-0.18 

-0.48 

-0.84 

-1.20 

-1.68 

-2.10 

-1.92 

-1.20 

-0.96 

-1.44 

-1.62 

-1.38 

-0.96 

-0.36 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

O.OC 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

oo 

r— 4 

o 

1 

-0.36 

-1.20 

-2.40 

-3.06 

-3.06 

-3.00 

-3.00 

-3.06 

-3.18 

-3.24 

-3.24 

-2.94 

-2.64 

-2.22 

-1.86 

-1.38 

-0.66 

-0.36 

-0.36 

-0.24 

-0.06 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0,00 

0.00 

|M 

0  00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

o.co 

0.00 

0.00 

0.00 

0.00 

0.00 

-0.36 

-1.02 

-1.50 

-1.86 

-1.98 

-1.80 

1.50 

-1.20 

-0.78 

-0.24 

0.00 

0  00 

0.00 

O.OC 

-0.42 

-1.26 

-1.68 

-1.68 

-2.34 

-3.30 

-4.02 

-4.20 

-4.68 

-5.46 

-5.76 

-5.46 

CO 

CM 

-5.22 

-5.22 

-5.22 

-4.80 

-4.08 

-3.12 

-2.22 

-1.56 

-1.38 

-0.96 

-0.36 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

O.OC 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

-0.06 

-0.24 

-0.48 

-0.84 

-1.62 

-2.64 

-3.48 

-3.72 

-  3 . 6o 

-3.24 

-2.64 

-2.16 

-1.56 

-1.26 

-0.78 

-0.24 

0.00 

0.00 

-1.08 

-2.94 

3.96 

-3.78 

-4.44 

-5.82 

-6.30 

-5.76 

-6.00 

-6.72 

-7.02 

-6 . 78 

-6.78 

-7.20 

-7.38 

-7.38 

-6.60 

-5.28 

-4.20 

-3.72 

-3.24 

-3.00 

-2.34 

-1.50 

-0.78 

-0.24 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

O.OC 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

U.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

-0.78 

-0.48 

-0.18 

0.00 

0.00 

-0.36 

-1.02 

-1.44 

-1.62 

-1.80 

-1.86 

-2.22 

-2.58 

-3.30 

-4.08 

-4.74 

-5.04 

-4.80 

-4.08 

-3.42 

-3.06 

-2.58 

o 

CSi 

-1.62 

-1.50 

-1.20 

-0.84 

-1.86 

-3.66 

-5.58 

-8.16 

-8.16 

00 

-7.44 

-7.62 

-8.64 

-9.18 

-9.06 

-9.24 

P 

5-61 

-9 

.54 

-9 

.42 

-8 

.76 

-3 

.12 

-1 

.80 

-0 

.66 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

C 

.00 

0 

.00 

0 

.00 

0 

o 

o 

-1 

.80 

-1 

.56 

-1 

.68 

-3 

.18 

-3 

.42 

-4 

.20 

-4 

.86 

-4 

.32 

-3 

.12 

-10 

.08 

-10 

.50 

-9 

.42 

-11 

.76 

-11 

.10 

-9 

.84 

-4 

.44 

-3 

.00 

-2 

.04 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

o 

o 

-3 

.42 

-3 

.42 

-3 

.78 

-4 

.32 

-4 

.68 

-5 

.76 

-7 

.56 

-6 

.72 

-5, 

.04 

-11 

.10 

-11 

.22 

-10 

.50 

-13 

.20 

-12 

.48 

-11 

.10 

-6 

.06 

-4 

.98 

-4, 

.02 

0 

.00 

0 

.00 

0. 

.00 

0 

.00 

0 

.00 

0. 

.00 

0 

.00 

0 

.00 

0 

O 

o 

-5 

.10 

-5 

.46 

-5. 

.88 

-5 

.82 

-6. 

.06 

-6. 

96 

-10. 

.44 

-9. 

.48 

-7. 

38 

-11. 

.10 

-11. 

.82 

-11. 

64 

-13. 

.98 

-13 

.14 

-12, 

.12 

-7. 

.44 

-6. 

42 

-5. 

70 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

.00 

0. 

00 

0. 

00 

0 

.00 

0 

o 

o 

-6. 

54 

-6. 

90 

-7. 

32 

-6. 

90 

-7. 

08 

-7. 

74 

-11. 

52 

-11. 

.34 

-9. 

90 

-10. 

68 

-11. 

58 

-11. 

40 

-14. 

88 

-14. 

04 

-13. 

44 

-8. 

88 

-7. 

98 

-7. 

62 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0 

.00 

0 

.00 

-9. 

00 

-8. 

64 

-8. 

04 

-7. 

68 

-7. 

68 

-7. 

92 

-11. 

28 

-12. 

42 

-12. 

36 

-10. 

14 

-10. 

98 

-10. 

86 

-14. 

76 

-13. 

98 

-14. 

16 

-10. 

32 

-9. 

36 

-8. 

76 

-0. 

42 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0. 

00 

0 

o 

o 

-12. 

00 

-11. 

52 

-10. 

26 

-9. 

06 

-8. 

76 

-8. 

58 

-9. 

48 

-10. 

80 

-11. 

88 

-9. 

96 

-10. 

98 

-11. 

28 

-7 

.68 

-6 

.54 

-5 

.58 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

-1 

.80 

-1 

.98 

-2 

.46 

-4 

.98 

-5 

.58 

-6 

.18 

-2 

.58 

-2 

.64 

-2 

.76 

-8 

.76 

-8. 

.82 

-9, 

,54 

-8 

.76 

-8 

.28 

-7 

.44 

-1 

.02 

-0 

.36 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

0 

.00 

-4 

.02 

-3 

.96 

-4 

.26 

-6 

.48 

-6 

.54 

-6 

.96 

-4 

.02 

-4 

.02 

-4, 

.62 

-10 

.26 

-10 

.68 

-11 
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-101.16  -100.68  -100.68  -101.10  -101.16 
-100.98  -100.62  -100.38  -100.32  -101.64 
-138.90  -147.18  -155.46  -157.80  -162.36 
-183.60  -186.90  -191.46  -193.80  -197.46 
-225.18  -228.84  -234.36  -237.66  -246.00 
-295.32  -299.94  -308.22  -313.86  -322.14 
-359.04  -365.04  -373.32  -377.58  -385.86 
-448.08  -475.26  -498.24  -499.50  -495.72 

-103.74  -103.32  -103.38  -103.62  -103.80 
-104.88  -104.70  -105.36  -105.72  -109.92 
-150.18  -158.76  -166.86  -169.86  -175.08 
-199.08  -202.08  -205.68  -207.54  -211.08 
-236.82  -242.34  -248.46  -250.92  -258.96 
-309.42  -313.74  -320.04  -324.90  -332.04 
-369.00  -375.72  -382.86  -385.86  -394.62 
-468.48  -494.40  -507.42  -503.70  -499.86 

-104.10  -104.10  -104.16  -104.40  -104.58 
-105.72  -105.60  -106.38  -107.64  -112.20 
-153.18  -159.78  -168.00  -171.72  -177.24 
-201.24  -204.96  -208.62  -209.58  -213.24 
-239.10  -245.10  -251.58  -253.86  -262.14 
-312.48  -315.72  -322.14  -326.82  -334.14 
-371.04  -376.68  -384.00  -387.72  -396.96 
-475.20  -491.76  -504.48  -502.56  -498.96 

-106.02  -106.50  -106.98  -107.16  -107.28 
-111.60  -112.08  -116.10  -119.64  -126.72 
-166.92  -170.58  -176.88  -182.40  -189.48 
-211.26  -215.52  -219.06  -219.66  -224.04 
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-228.96  -234.30 
-282.00  -291.84 
-349.80  -355.14 
-416.82  -427.56 
-499.20  -502.50 
PLOTREC 


-236.70  -239.46 
-299.16  -309.84 
-358.14  -366.12 
-434.94  -451.86 
-502.50 


-241.32  -247.56 
-317.16  -324.30 
-373.44  -381.48 
-468.36  -482.88 


-254.94  -263.70 
-326.70  -332.88 
-385.80  -392.88 
-488.40  -492.06 


-267.30  -275.28 
-338.40  -345.48 
-398.40  -408.24 
-492.66  -496.80 
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CHAPTER  6 

CLHYD  -  A  CURVILINEAR  LONG  WAVE  HYDRODYNAMIC  MODEL 


THEORY  AND  PROGRAM 


•KVJiMil 


:atioh 


PART  I :  INTRODUCTION 


1.  Use  of  time -dependent  numerical  models  for  simulating  long-period 
wave  behavior  in  open  coastal  waters,  estuaries,  bays,  and  lakes  has  increased 
rapidly  in  recent  years.  Two-  and  three-dimensional  numerical  solutions  of 
the  governing  partial  differential  equations  are  employed  in  most  shallow- 
water  long-wave  applications.  This  chapter  documents  the  Curvilinear  Long¬ 
wave  HYDrodynamic  (CLHYD)  model.  CLHYD  is  a  two-dimensional,  depth -averaged 
model  for  computing  tidal  circulation  and  storm  surge  propagation.  This 
finite  difference  model  is  developed  in  boundary- fitted  (curvilinear) 
coordinates . 

2.  CLHYD  is  a  two-dimensional  model;  therefore,  velocities  are  treated 
as  depth- averaged  quantities  (i.e.,  velocities  are  constant  in  magnitude  and 
direction  over  depth) .  The  model  solves  finite  difference  approximations  of 
the  Navier-Stokes  (continuity  and  horizontal  momentum)  equations  for  the  water 
surface  displacement  (S)  and  the  unit  flow  rate  components  ( U  and  V) .  CLHYD 
can  simulate  flow  fields  induced  by  wind  fields,  river  inf lows/outf lows ,  and 
tidal  forcing. 

3.  The  potential  user  must  have  a  thorough  understanding  of  the  model's 
capabilities  and  limitations  before  applying  it  to  a  particular  study.  CLHYD 
is  not  a  "total  solution"  to  a  hydrodynamic  problem.  The  user  must  ensure 
that  limitations  imposed  by  shallow-water  wave  theory  (i.e.,  water  depth  is 
sufficiently  small  when  compared  with  wavelength)  are  applicable  to  the 
problem  being  investigated.  Furthermore,  the  model  should  not  be  treated  as  a 
"black  box";  the  engineer  or  scientist  must  check  model  results  to  see  if 
these  results  are  reasonable. 

4.  This  chapter  is  divided  into  five  sections:  Part  II  presents  the 
governing  equations  and  computational  scheme  used  in  the  model,  Part  III 
defines  the  input  data  formats,  Part  IV  discusses  the  model's  input  data 
requirements,  and  Part  V  contains  several  illustrative  examples. 
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PART  II:  CLHYD  MODEL  FORMULATION 


5.  Time -dependent  numerical  models  used  to  simulate  long-period  wave 
behavior  in  open  coastal  waters ,  estuaries ,  bays ,  and  lakes  have  gained 
increasing  acceptance  as  their  accuracy  has  been  demonstrated  (Leendertse 
1971).  Both  two-  and  three-dimensional  numerical  solutions  of  the  governing 
partial  differential  equations  are  employed  in  long-wave  applications.  In 
two-dimensional  models,  the  governing  three-dimensional  equations  are  inte¬ 
grated  over  the  water  depth  to  yield  vertically  averaged  velocities,  that  is, 
velocities  that  are  constant  through  the  water  column.  This  chapter  documents 
the  two-dimensional  CLHYD  model  for  simulating  long-wave  behavior  (tidal 
circulation  and  storm  surge  propagation)  in  the  horizontal  plane  in  relatively 
shallow,  well-mixed  bodies  of  water.  It  should  be  noted,  however,  that 
without  flooding  and  drying  capabilities,  storm  surge  applications  may  be 
questionable.  These  features  will  be  incorporated  in  a  later  release  of 
CLHYD. 


Assumptions  and  Limitations 

6.  Proper  application  of  the  model  requires  a  clear  understanding  of 
the  physical  processes  occurring  in  a  study  area  and  a  comprehension  of  the 
capabilities  of  the  model  to  simulate  those  processes.  The  limitations  of  a 
model  define  its  range  of  applicability.  In  particular,  CLHYD  is  a  two- 
dimensional  depth -averaged  model;  therefore,  the  model  should  be  applied  only 
where  the  water  column  is  well  mixed  and  no  significant  vertical  variations 
occur.  Hydrostatic  pressure  conditions  are  assumed  in  the  model  formulation. 
Thus,  the  model  should  be  applied  only  where  there  is  no  significant  vertical 
acceleration  of  the  water. 

7.  Applying  CLHYD  requires  a  clear  understanding  of  the  model's 
capabilities  as  well  as  its  limitations.  The  model  should  be  applied  such 
that  time  and  length  scales  associated  with  long-wave  processes  can  be 
resolved.  The  minimum  wavelength,  L  ,  that  can  be  resolved  is  a  function  of 
the  grid  resolution  and  the  water  depth,  H  .  The  smallest  wavelength  that  can 
be  resolved  is  equal  to  twice  the  width  of  the  smallest  grid  cell;  however, 
long-wave  models  generally  use  much  greater  wavelength-to-grid-cell-width 
ratios.  In  addition,  limitations  imposed  by  shallow-water  wave  theory  must  be 
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valid  for  a  problem  under  investigation.  Shallow-water  wave  theory  is  valid 
only  where  the  water  depth  is  small  in  relation  to  the  wavelength  ( H/L 
<  0.04).  Therefore,  the  minimum  wavelength  must  be  greater  than  or  equal  to 
25  times  the  deepest  water  depth. 

8.  Presently,  the  model  lacks  a  flood/dry  capability  and  cannot  treat 
submerged  or  overtopping  barriers.  These  features  will  be  incorporated  and 
released  in  a  subsequent  version  of  CLHYD.  A  thorough  comprehension  of  the 
physical  processes  simulated  by  the  model  is  necessary  to  ensure  that  the 
model  is  applied  to  appropriate  problems,  that  it  is  applied  correctly,  and 
that  accurate  results  are  produced. 

9.  A  discussion  of  the  hydrodynamic  equations  used  in  CLHYD  is  provided 
in  the  following  section.  It  is  recommended  that  the  reader  refer  to  Horikawa 
(1988)  for  a  detailed  discussion  of  coastal  hydrodynamics. 


Governing  Equations 


10.  The  hydrodynamic  equations  used  in  CLHYD  are  derived  from  the 
classical  Navier- Stokes  equations  formulated  in  a  Cartesian  coordinate  system 
(Figure  6-1).  If  the  vertical  water  accelerations  are  assumed  to  be  small 
compared  with  the  gravitational  acceleration  (hydrostatic  pressure  conditions 
exist)  and  the  fluid  is  homogeneous,  the  depth- averaged  approximation  is 
appropriate  and  yields  the  following  two-dimensional  form  of  the  governing 
equations : 


dt  dx\  H I  dy\  H 
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Figure  6-1.  Definition  sketch  for 
Cartesian  coordinate  system 


where 

x,  y,  t  - 

S  - 

h  - 
H  - 

U,  V  - 


rBx »  TBy 


f  - 


AH 

8 
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P  - 

Equations  6-1, 


independent  space  and  time  variables 

water  surface  displacement  measured  relative  to  an  arbitrary 
datum 

static  water  depth  measured  from  the  same  datum 
total  water  depth  (h+S) 

unit  flow  rate  components  in  the  x-  and  y-directions, 
respectively 

bottom  friction  components  in  the  x-  and 
y-directions,  respectively 

Coriolis  parameter 

generalized  dispersion  coefficient 

gravitational  acceleration 

external  surface  shear  stresses,  such  as  wind  stress,  in  the  x 
and  y-directions,  respectively 

fluid  density  (assumed  to  be  constant) 

6-2,  and  6-3  represent  the  x-momentum,  y-momentum,  and  continu 


ity  equations,  respectively. 
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11.  A  detailed  discussion  of  the  Navier- Stokes  equations  with  a 
rigorous  derivation  of  each  term  is  found  in  Harris  and  Bodine  (1977).  A 
brief  discussion  of  the  physical  significance  of  the  six  groups  of  terms  in 
Equations  6-1  through  6-3  is  given  in  Table  6-1  and  below.  The  Roman  numerals 
below  correspond  to  the  Roman  numerals  in  Equations  6-1  through  6-3: 

I.  Local  flow  acceleration  (i.e.,  local  variation  of  momentum  with 
respect  to  time) . 

II.  Transport  of  momentum  by  advection  (i.e.,  spatial  acceleration). 

III.  Barotropic  pressure  forces  and  conservation  of  mass. 

IV.  Momentum  sources  and  sinks  due  to  Coriolis  force  and 
surface  wind  stress. 

V.  Momentum  sink  due  to  bed  friction. 

VI.  Horizontal  dispersion  of  momentum. 

12.  Various  formulations  of  the  terms  in  the  governing  equations  are 
permissible.  The  expressions  for  bottom  friction,  dispersion,  wind  stress, 
and  the  Coriolis  coefficient  employed  in  CLHYD  are  given  below: 

Bottom  friction 

13.  The  bottom  shear  stress  impeding  fluid  motion  in  unidirectional 
open  channel  flow  can  be  expressed  in  terms  of  a  quadratic  (nonlinear) 
friction  law  (Dean  and  Dalrymple  1984) : 

Tb  =  (6-4) 

B  8 


where 

p  -  fluid  density 

f  -  Darcy- We isbach  friction  factor 

u  -  fluid  velocity 

The  importance  of  the  direction  of  the  velocity  in  oscillatory  flow  means  that 
Equation  6-4  must  contain  an  absolute  value  sign: 

_£fluiu  (6_5) 

*  8 
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Table  6-1 


Description  of  Terns  in  the  Governing  Equations 


Term 

Definition  and  Discussion 

du  dv 

It'  It 

Change  of  the  vertically  averaged  flow  per  unit  width 
with  respect  to  time.  Change  may  result  from  temporal 
acceleration  of  the  mean  flow. 

„„  ds  3S 

Pressure  gradient  terms;  describes  the  slope  of  the 
water  surface;  principal  driving  force  of  fluid  flow. 

xBx'  xBy 

Bottom  friction  terms;  stress  of  the  fluid  layer 
against  the  bottom  boundary;  serves  as  an  energy  dissi- 
pator . 

fu,  fv 

Coriolis  terms;  accounts  for  the  effect  of  the  Earth's 
rotation. 

£(f) 

Advective  (inertia)  terms;  describes  the  movement  of 
water  due  to  the  fluid  motion  itself. 

X»x'  x  *y 

External  shear  stresses  (such  as  the  wind) ;  any  forcing 
function  that  serves  to  drive  the  fluid  motion. 

H  dx2  dy2  J 

Horizontal  dispersion  of  momentum;  describes  the  dis¬ 
persion  of  momentum  due  to  fluid  motion;  is  some¬ 
times  referred  to  as  the  eddy  viscosity. 

dS 

It 

Change  in  water  level  with  respect  to  time. 

dU  dU 
dx'  dy 

Rate  at  which  water  is  converging  or  diverging  horizon¬ 
tally  at  a  given  point  (x,y)  in  space. 

14.  CLHYD  uses  the  following  quadratic  expression  to  represent  the 
bottom  shear  stress  in  the  x-momentum  equation: 
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* 


(6-6) 


Jlfi  +  V*U 


where 

g  -  gravitational  acceleration 

Cz  -  Chezy's  friction  coefficient 

H  -  water  depth 

U,  V  -  unit  flow  rate  components  in  the  x-  and  y-directions , 

respectively 

A  similar  expression  is  used  for  r gy  in  the  y-momentum  equation. 

15.  Rather  than  specifying  the  Chezy  coefficient,  Manning's  n  ,  which 
is  a  function  of  depth,  is  often  prescribed  (Chow  1959).  The  two  coefficients 
are  related  through  the  following  equation: 


C.  = 


H1/s 

n 


CLHYD  uses  a  spatially  variable  Manning's  coefficient.  The  advantage  of  a 
spatially  variable  friction  coefficient  is  that  variation  in  depth  and  bottom 
roughness  can  be  factored  into  the  bottom  shear  stress  computations. 

Dispersion  coefficient 

16.  The  dispersion  coefficient,  AB  ,  is  treated  as  a  constant  in  CLHYD 
and  describes  the  rate  of  dispersion  of  momentum  due  to  the  fluid  motion.  AH 
is  a  function  of  the  grid  spacing  and  may  take  a  value  of  100  m2/sec  or  more 
for  a  grid  spacing  of  several  kilometers.  Due  to  the  current  representation 
of  the  advective  terms  in  CLHYD,  results  are  not  extremely  sensitive  to  AH  . 
Wind  stress  coefficient 

17.  The  wind  stress,  r,  ,  is  formulated  as: 

t,  *  CD\W\W  (6-8) 


where  W  is  the  wind  velocity,  CD  is  the  wind  drag  coefficient  determined 
from  Garratt's  equation  (Garratt  1977): 


= 


(0.75  +  0.067m) 
1000 


(6-9) 


and  w  is  the  resultant  wind  speed  (meters/second) . 
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CqgidUs  coefficient 

18.  The  Coriolis  tern  accounts  for  the  fact  that  the  Earth  is  rotating, 
whereas  the  coordinate  frame  of  our  computations  is  fixed.  The  Coriolis 
parameter,  f  ,  is  expressed  as: 

f  =  2vsinX  (6-10) 

where  v  is  the  angular  speed  of  the  Earth’s  rotation  (7.292  x  10~5  rad/sec) 
and  A  is  the  latitude  of  the  study  area. 

19.  This  completes  the  basic  model  formulation.  If  further  details  are 
desired,  the  reader  should  refer  to  Roache  (1976)  or  Horikawa  (1988). 

Grid  Systems 

20.  The  governing  equations  (Equations  6-1,  6-2,  and  6-3),  which 
describe  the  physical  processes  associated  with  shallow- water  wave  motion, 
contain  partial  derivatives  with  respect  to  time  and  space.  Model  CLHYD  uses 
mathematical  (finite  difference)  approximations  to  represent  these  continuous 
equations.  The  continuum  is,  therefore,  represented  by  discrete  points  in 
time  and  space.  The  discretization  of  the  horizontal  plane  is  accomplished 
via  a  computational  grid  composed  of  a  lattice  network  of  cells.  Each  cell 
has  certain  flow  field  parameters  associated  with  it.  In  the  case  of  the 
model  CLHYD,  the  water  surface  elevation  is  defined  at  the  center  of  each  cell 
and  the  unit  flow  rate  components  are  defined  on  the  cell  faces.  All  informa¬ 
tion  required  as  input  to  the  model,  including  water  depths  and  external 
forces  (such  as  wind),  is  also  defined  at  each  cell. 

21.  CLHYD  is  capable  of  using  a  uniform  Cartesian  grid,  a  stretched 
Cartesian  grid,  or  a  general  curvilinear  grid  (Figures  6-2  through  6-4).  Each 
successive  type  of  grid  can  provide  a  more  accurate  representation  of  an  area; 
however,  the  complexity  of  the  governing  equations  increases  with  each 
successive  grid  type. 

22.  Uniform  Cartesian  grids  simply  have  cells  of  equal  size  in  the  x- 
direction  and  equal  size  in  the  y-direction.  The  advantages  of  using  a 
uniform  Cartesian  grid  are:  (a)  the  simplicity  of  generating  a  grid;  (b)  the 
simplicity  of  formulating  the  governing  equations;  (c)  there  are  fewer  terms 
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Figure  6-2.  Uniform 
Cartesian  grid 


Figure  6-3.  Stretched 
Cartesian  grid 


in  the  governing  equations ,  and  therefore ,  the  computational  requirements  are 
minimized;  and  (d)  uniform  grids  have  been  widely  used  and  thoroughly  tested. 
The  disadvantages  of  using  a  uniform  Cartesian  grid  include:  (a)  they  lack 
the  ability  to  increase  grid  resolution  in  areas  of  interest;  (b)  conse¬ 
quently,  it  is  usually  uneconomical  to  use  a  fine -resolution  grid  throughout 
an  entire  area;  and  (c)  they  cannot  efficiently  resolve  an  irregular  shoreline 
and  therefore  require  "stair-stepping,"  which  can  lead  to  computational 
inaccuracies  (Weare  1979) . 

23.  Stretched  Cartesian  grids  are  flexible  enough  to  increase  grid 
resolution  and,  therefore,  provide  a  more  economical  representation  of  an  area 
than  a  uniform  Cartesian  grid.  In  other  words,  the  number  of  grid  cells 
required  to  represent  an  area  can  be  reduced  by  using  a  stretched  grid,  which 
in  turn  reduces  computational  costs.  However,  one  must  also  consider  that  the 
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number  of  terms  in  the  governing  equations  increases  when  going  from  a  uniform 
to  a  stretched  grid. 

24.  Neither  the  uniform  nor  the  stretched  Cartesian  grids  can  accurate¬ 
ly  depict  irregular  shorelines  and  must  therefore  resort  to  "stair-stepping." 
However,  nonorthogonal  curvilinear  (boundary- fitted)  grids  can  be  made  to 
conform  to  bathymetric  features  and  provide  an  accurate  means  of  representing 
a  study  area  (Figure  6-4).  These  grids  can  be  generated  using  a  numerical 
grid  generator  such  as  program  EAGLE  (Thompson  1985),  which  has  the  flexibili¬ 
ty  to  concentrate  grid  lines  in  shallow/deep  areas  or  in  areas  where  the 
bathymetric  gradients  are  great.  With  the  increase  in  accuracy  and  adaptabil¬ 
ity  comes  increased  complexity  of  the  governing  equations  and  the  associated 
computational  costs.  In  addition,  general  curvilinear  grids  are  complex 
networks  and  are  therefore  more  difficult  to  generate.  However,  the  increased 
accuracy  and  adaptability  are  often  necessary  to  adequately  represent  features 
in  coastal  areas. 

25.  For  areas  having  irregular  geometries,  model  CLHYD  is  capable  of 
using  a  nonorthogonal  curvilinear  grid.  Thompson  (1983)  developed  a  method 
for  generating  two-dimensional  boundary-fitted  grids  by  solving  elliptic 
equations.  These  equations  relate  the  nonorthogonal  curvilinear  coordinate 
system  in  the  physical  plane  (x,y)  with  a  uniformly  spaced  coordinate  system 
in  the  transformed  plane  (£,17)  (Figure  6-5).  The  elliptic  equations  are: 


+ 

rrt 

$ 

II 

(6-11) 

+  T\yy  =  Q 

(6-12) 

with  the  following  boundary  conditions: 

t)  =  constant  }  on  nort^  and  south  boundaries 

q  =  qC(xSyfT3t  }  on  east  anc*  west  boundaries 

where  the  functions  P  and  Q  may  be  chosen  to  obtain  the  desired  grid 
resolution  and  alignment. 

26.  When  using  a  nonorthogonal  curvilinear  grid,  the  governing  equa¬ 
tions  must  be  transformed  into  curvilinear  coordinates.  A  straightforward 
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NORTH 


NORTH 


Figure  6-5.  Physical  and  transformed  planes 


method  is  to  transform  only  the  dependent  variables  (x,y)  and  then  solve  for 
the  Cartesian  components  of  the  velocity  and  water  surface  displacement 
Johnson  1982) .  The  advantage  of  this  method  is  its  simplicity  in  generating 
the  transformed  equations  via  the  chain  rule;  although  the  resulting  equations 
are  quite  complex.  Disadvantages  are:  (a)  the  boundary  conditions  are 
complicated  because  the  Cartesian  velocity  components  are  generally  not 
aligned  with  the  grid  lines;  (b)  a  staggered  grid  (i.e.,  a  grid  in  which 
values  of  velocity  and  water  surface  elevation  are  defined  at  different 
points)  cannot  be  readily  used;  and  (c)  numerical  instabilities  may  develop 
(Sheng  1986). 

27.  To  avoid  these  problems,  Sheng  transformed  the  dependent  (S ,U ,V)  as 
well  as  the  independent  variables  (x,y).  Vector  quantities  (e.g.,  U ,V)  are 
transformed  by  multiplying  the  vector  by  a  scale  factor.  Scalar  quantities 
(e.g.,  S)  in  the  physical  plane  are  the  same  in  the  transformed  plane; 
however,  the  spatial  derivatives  require  transformation  via  scale  factors. 
Equations  in  the  transformed  plane  ( £,r j)  can  be  obtained  in  terms  of  the 
contravariant,  covariant,  or  physical  velocity  components  via  coordinate 
transformations  (Thompson  1985).  Sheng  recommended  use  of  contravariant 
components.  Contravariant  components  (a1,  a2,  a3)  are  normal  to  coordinate 
planes,  and  covariant  components  (a1(  33)  are  tangential  to  coordinate 

lines  (Figure  6-6).  The  three  components  are  identical  in  a  uniform  cartesian 
coordinate  system  with  square  grid  cells,  but  differ  for  other  systems.  Model 
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CLHYD  employs  contravariant  components  In  the  transformation  of  the  governing 
equations . 

28.  The  flow  rate  components  in  physical  space  (i.e.,  U(i)  and  V(j)) 
are  related  to  the  contravariant  components  (i.e.,  UL  ,  V1  ,  t/J  ,  VJ)  by  the 
following  equations: 


where : 

4  +  A  +  yjy„ 

9 U  ■  z  2 

+  y^{  **  *  K 


(6-13) 


(6-14) 


(6-15) 


or 


9ij 


9\i 
9l\  9 22 


(6-16) 


and  |g|  is  the  determinant  of  the  metric  tensor 
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|?|  “  9\\9n  ~ 


(6-17) 


The  surface  slope  terns  are  transformed  as  follows: 


dS 


(6-18) 


85 

S? 


+ 


85 


(6-19) 


where  giJ  are  Inverse  metric  tensor  components: 


9ij 


1 

-(x^xf+y,yt) 

_  l 

522  “521 

TFT 

-(xixn*yly^)  3$  ♦  y\ 

■Rrf 

~9\z  9xi 

(6-20) 


or 


'911  912 
j9 21  5". 


(6-21) 


For  details  of  these  transformations,  the  reader  Is  referred  to  Thompson 
(1985)  . 


Governing  Equations  in  General  Curvilinear  Coordinates 

29.  The  transformed  governing  equations  developed  by  Sheng  (1985)  are 
as  follows: 

6 -Momentum 


du 

dt 


+  Inertia * 


(6-22) 


.  Diffusion-  ■  0 

cjw2 
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n -Momentum 


dV 

It 


+  Inertia '  +  gH 


(gai 


dS 


,  dS 


Afu 

Iffvl 


(6-23) 


♦  2g„UV  *  g22V*)1/2 
C*lP 


V  +  Diffusion * 


Continuity 


I? +  T^rl(bJt/)  +  =  0 


(6-24) 


where 


U,V  - 


giJ  -  inverse  metric  tensor  components 

gij  -  metric  tensor  components 

| g8 1  -  determinant  of  the  metric  tensor,  |g| 

|gu|  -  determinant  of  the  metric  tensor,  |g| 

|gv|  -  determinant  of  the  metric  tensor,  |g| 

U  -  average  x-direction  unit  flow  rate  at  a  V-face 

y  -  average  y-direction  unit  flow  rate  at  a  U- face 

Inertia  and  dispersion  terms  are  given  in  Appendix  6 -A 
S- ,  U-,  V-points  are  defined  in  Figure  6-7 


contravariant  unit  flow  rate  components  in  the  transformed 
plane  (superscripts  have  been  dropped  for  convenience) 


at  an  S-point 

at  an  U- face** 

at  an  V-face** 
** 


Finite  Difference  Methods 

30.  Although  analytic  solutions  of  the  governing  equations  exist  for 
simple  situations,  they  do  not  exist  for  situations  generally  encountered  in 
the  field.  Therefore,  it  is  necessary  to  use  numerical  approximations  of  the 
governing  equations  to  produce  a  general  purpose  model.  This  can  be  accom¬ 
plished  by  representing  the  derivatives  presented  in  Equations  6-22  through  6- 
24  with  finite  difference  approximations. 

31.  In  the  finite  difference  approach,  the  continuous  problem  domain  is 
discretized  so  that  dependent  variables  are  defined  only  at  discrete  points. 
Derivatives  are  approximated  by  differences  resulting  in  an  algebraic  problem. 


6-14 
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Figure  6-7.  Definition  of  variable  positions 


Several  factors  determine  whether  the  solution  obtained  is  a  good  approxima¬ 
tion  to  the  exact  solution  of  the  original  partial  differential  equation  (PDE) 
including:  truncation  error,  numerical  stability,  round-off  error,  and 
discretization  error.  These  factors  will  be  discussed  later  in  this  section. 

32.  As  was  previously  mentioned,  the  continuous  problem  domain  is 
represented  with  a  finite  difference  grid  in  the  (x,y)  or  (C , *7 )  plane 
(Figure  6-8).  It  should  be  noted  that  the  ( x,y )  and  (£,17)  planes  can  be  used 
interchangeably  here.  The  (x,y)  plane  is  used  merely  for  explanation  purpos¬ 
es.  If  a  variable  a(x,y)  is  defined  at  each  point  on  the  grid  as 
a(iAx,jAy)  ,  then  a  difference  equation  can  be  written  in  terms  of  the  general 
point  (i,j)  and  its  neighboring  points: 

atj  =  a(x,y)  ai*i,j  “  a(x+Ax,y)  ai,j.i  “  a(x,y+Ay) 

=  a(x-Ax,y)  ~  a{x,y-Ay) 


33.  Recall  that  the  definition  of  the  derivative  of  a  function  a(x,y) 
at  a  point  (x  -  x0,  y  -  y0 )  is  given  by: 


da 

Si 


'v. 


=  lim 
Ax-0 


a  (x0+Ax,y0)  -  a(x0,y0) 

Ax 


(6-25) 


This  approximation  improves  as  Ax  decreases.  Developing  a  Taylor  series 
expansion  for  a(x+Ax,y)  about  (x0,y0)  yields: 
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Figure  6-8.  Finite  difference  grid 


a(x0+Ax,y0) 


a(xo,y0) 


•f 


da 


Ax 


+ 


8»a 

ax3 


(Ax)3 

2! 


+  H.O.  T. 


where  H.O.T.  signifies  Higher  Qrder  lerms. 

A  forward  difference  is  formed  by  rearranging  Equations  6-26: 

dal  „  a(x0>Ax,y„)  -  a(x0,y0)  _  d?a|  (Ax)  +  n  o  T 

Ax  *E*Ur.  21 


or  by  simply  using  the  (i,j)  notation,  the  following  is  obtained: 

=  "  a^  +  o(  Ax) 


da 

dx 


i .) 


Ax 


(6-26) 


(6-27) 


(6-28) 


where  O(Ax)  is  used  to  indicate  terms  of  order  Ax.  The  backwards  differ¬ 
ence  can  be  obtained  similarly  as: 

~  a^i  ♦  0(Ax)  (6-29) 

dxj  ^  Ax 


The  central  difference  representation  is  as  follows: 

~  +  o(Ax) 3  (6-30) 

dx\t  j  2Ax 


These  are  only  a  few  examples  of  the  ways  in  which  derivatives  can  be  approxi¬ 
mated.  Primarily  central  differences  are  used  to  approximate  spatial  deriva¬ 
tives  in  the  formulation  of  CLHYD. 
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34.  The  accuracy  of  these  approximations  is  dependent  on  a  number  of 
factors.  Round-off  error  is  inherent  to  repetitive  computations  that  are 
rounded  to  a  finite  number  of  digits,  such  as  the  continual  solution  of  the 
finite  difference  equations  in  CLHYD,  by  a  computer.  Truncation  error  is 
defined  as  the  difference  between  the  PDE  and  the  difference  approximation.  A 
finite  difference  representation  is  said  to  be  consistent  if  the  truncation 
error  vanishes  as  the  grid  is  refined.  A  more  difficult  problem  is  ensuring 
that  the  solution  scheme  is  stable.  A  stable  scheme  does  not  permit  errors, 
such  as  truncation  or  round-off  to  grow  as  the  calculations  proceed  from  one 
time-step  to  another.  Discretization  error  is  the  error  in  the  solution  to 
the  PDE  caused  by  replacing  the  continuous  problem  by  a  discrete  one,  and  it 
is  defined  as  the  difference  between  the  exact  solution  of  the  PDE  and  the 
exact  solution  to  the  finite  difference  equation.  In  other  words,  it  is  the 
sum  of  the  truncation  error  and  any  errors  introduced  by  the  treatment  of  the 
boundary  conditions. 

35.  The  finite  difference  approximations  incorporated  into  CLHYD  are 
based  on  an  Eulerian  system  where  the  velocities  and  water  surface  fluctua¬ 
tions  are  computed  at  discrete  locations  within  the  flow  field.  A  network  of 
grid  cells  is  used  to  define  the  parameter  locations.  A  representative  grid 
cell  in  computational  space  (£  ,tj)  is  shown  in  Figure  6-7.  In  this  staggered 
grid,  the  water  surface  fluctuation  is  defined  at  the  cell  center  (i,j)  ,  £- 
direction  unit  flow  rates  (U)  are  defined  at  the  "west"  (i,j)  and  "east" 
(i+l,j)  cell  faces,  and  the  ^-direction  unit  flow  rates  (V)  are  computed  at 
the  "south"  (i,j)  and  "north"  (i,j+l)  cell  faces.  The  finite  difference 
approximations  of  the  governing  equations  follow.  Note  that  the  continuity 
equation  is  split  into  two  parts  (Equations  6-33  and  6-34)  to  be  used  in  the 
solution  scheme  described  in  paragraph  36.  The  sum  of  these  equations  is  the 
one  original  continuity  equation. 
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£ -Momentum 


*  Ili  *  AC''1^) 


(6-31) 


( l  -6)  Si,i  ^Si  l*'J)  + 


^Z-i/a, j-i/a  ~  ^i-i/2,j-i/3 

At) 


)- 


*  B(FRlOUl,j  +  (1-0)  ( FRlOvf'j  *  Dli  =  0 


where 

n 

* 

n+1 

e 

I 

D 

and 


previous  time  level 
intermediate  time  level 
solve  for  this  time  level 

weighting  factor  between  successive  time  levels 

inertia 

dispersion 


FRIC  •  -ij  ♦  2 g^Ui'jV  ♦  g22v2)1'2 

evaluated  at  time  level  n 


Finite  difference  forms  of  the  inertia  and  dispersion  terms  are  given  in 
Appendix  6-A. 
n- Momentum 


v  ft  -  Yhi 
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III 


gHg*A 


cn  _  c° 
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(ciJ‘1  _  e«*l  {  cn  _  Qn  \ 

~J  Ati~  j  ♦  (1-0)  i,J 


+  S^Kfu  + 
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£ -Continuity 
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n- Continuity 
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Rearranging  the  terms  in  Equations  6-31  through  6-34  yields: 
f -Momentum 

e^-gHgll^sU.i  +  <i  ♦  Q(frio  a t)  if['j  *  differ11  =  b4 

Bx  B2  B3 

where:  B4  represents  all  known  quantities 


n -Momentum 


6(-^g»  A^-1-1  +  (1  +  0  (FRIO  A  C)  V?;j  ♦  .  Bt 


B, 


B, 


f -Continuity 


Ai  A2  A3 

vhere:  A4  represents  all  known  quantities 


(6-33) 


(6-34) 


(6-35) 


(6-36) 


(6-37) 
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Ai  A2 


a3 


(6-38) 


Computational  Theory 

36.  The  computational  procedure  used  In  CLHYD  Is  based  on  an  Alternat¬ 

ing  Direction  Implicit  (ADI)  scheme  (Roache  1976).  Using  this  method,  the  £- 
and  t) -momentum  equations  are  solved  separately,  and  each  calculation  in  time 
is  made  in  two  stages  (Figure  6-9).  In  the  first  stage,  the  ^-continuity  and 
£ -momentum  equations  are  solved  along  each  row  of  the  grid  to  progress  from 
time  level  n  to  an  intermediate  time  level  *.  The  £ -direction  unit  flow 
rate  components  and  water  surface  fluctuations  are  solved  implicitly,  and  the 
17-direction  unit  flow  rate  components  are  supplied  from  time  level  n.  The  £- 
direction  unit  flow  rates  from  this  step  represent  those  at  time  level  n+I  , 
whereas  the  water  surface  fluctuations  are  only  an  approximation  to  those  at 
time  level  n+I  .  The  ^-direction  unit  flow  rate  components  remain  at  time 
level  n  .  In  the  second  stage,  the  17-continuity  and  »7-momentum  equations  are 
solved  along  each  column  for  the  17-direction  unit  flow  rates  and  the  water 
surface  fluctuations  at  time  level  n+I  .  $ -direction  unit  flow  rate  compo¬ 

nents  are  supplied  from  the  first  stage  calculations. 

37.  As  shown  in  the  finite  difference  approximations  to  the  governing 
equations,  a  weighting  factor,  8  ,  is  used  to  place  the  water  surface  slope 
and  bottom  friction  terms  between  time  levels  n  and  n+I  .  When  the 
weighting  factor  equals  0.0,  these  terms  are  evaluated  at  the  previous  time 
level  n  (explicit  treatment),  whereas  when  the  weighting  factor  equals  1.0, 
they  are  evaluated  at  the  new  time  level  n+I  (implicit  treatment).  Usually 
a  value  between  0.0  and  1.0  is  used.  Tests  have  shown  that  a  value  of  0.55 
produces  a  stable  solution  with  less  damping  of  the  solution  than  occurs  with 
a  value  of  1.0. 
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Figure  6-9.  Computational  procedure  for  ADI  scheme 
Tridiaeonal  matrix 

38.  As  was  mentioned  earlier,  the  ^-direction  contiruity  and  momentum 
and  the  tj -direction  continuity  and  momentum  equations  are  solved  separately. 
For  a  given  segment  (Figure  6-10),  the  ^-continuity  and  ^-momentum  equations 
are  alternately  solved  at  S-  and  17-points,  respectively.  Similarly,  the  17- 
continuity  and  q -momentum  equations  are  alternately  solved  at  S-  and  F-points 


Figure  6-10.  £- sweep  solution  segment. 


The  equations  corresponding  to  Figure  6-10  are: 


C: 

M: 

C: 

M: 

C: 


A,,U,3  +  AZ1  S,j  +  Aj, 
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A  U 
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where  C:  indicates  the  x- continuity  equation  and  H:  indicates  the  x-aomentua 
equation,  or  in  matrix  fora: 


*2.1 

*3.1 

0 

0 

0  ' 

0 

*4.2 

-*1.1 

Ui.i 

^1 .2*1 

■82,1*1 

8j  ,2*1 

0 

0 

Si.J 

84,2*1 

0 

•*1,1*1 

*a,2*i 

•*3,2*1 

0 

s 

*4,2*1 

0 

0 

^1,1*2 

82,2*2 

83,1*3 

c 

84,1*2 

0 

0 

0 

■*1,2*2 

•*2,2*2 

*4,1*2 

"*3,1*2 

This  system  of  equations  is  in  the  form  of  a  banded  or  tridiagonal  matrix  and 
is  solved  using  the  Thomas  (1949)  algorithm  (Gaussian  elimination  and  back 
substitution  procedures). 

39.  In  the  Gaussian  elimination  step,  all  lower  diagonal  elements  (Ax's 
and  Bx's)  are  eliminated  and  are  incorporated  into  other  matrix  elements.  The 
system  of  equations  is  thus  reduced  to  an  upper  diagonal  matrix  with  only  two 
unknowns  per  equation.  The  back  substitution  sweep  then  involves  the  solution 
of  the  system  of  equations  for  all  variables,  t/x  and  Sx  . 

Boundary  conditions 

40.  The  matrix  equation  previously  shown  contains  N-2  simultaneous 
equations  containing  N  unknowns.  The  boundary  conditions  provide  the 
remaining  information  needed  to  solve  the  system  of  equations.  The  boundary 
conditions  are  classified  into  three  general  categories:  open  boundaries, 
land-water  boundaries,  and  subgrid  barriers. 

Open  boundaries 

41.  Boundaries  classified  as  open  include:  a  seaward  edge  of  a 
computational  grid  defined  as  water,  or  a  channel  (river)  that  flows  across 
any  boundary.  Water  surface  (tide)  levels  or  unit  flow  (river  flow)  rates  can 
be  specified  along  an  open  boundary  as  functions  of  time.  An  open  boundary 
can  also  be  specified  with  a  uniform  flux  (zero  gradient)  boundary  condition. 
Research  has  been  conducted  to  add  a  radiation  boundary  condition  option, 
which  relates  water  levels  and  flow  rates,  into  the  model.  This  option  will 
be  incorporated  in  a  later  release  of  CLHYD. 

Xldal  fe£und&£y 

42.  A  tidal  boundary  condition  (TBC)  allows  for  fluctuations  in  the 
free  surface  and  is,  therefore,  applied  at  an  S-point  (Figure  6-11).  The 
computations  proceed  from  the  first  internal  U- face  to  the  last  S-point.  For 
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TBC  fV>pU«d  TBC  Applied 

Figure  6-11.  Tidal  boundary  condition  (TBC) 


the  case  of  a  tidal  boundary  on  the  west  (or  south),  a  special  formulation  of 
the  momentum  equation  at  the  next  internal  17- face  is  required: 


+  a  ^4.1*1  “  &1, j 


(6-39) 


The  sweep  proceeds  from  this  17-point  to  the  easternmost  S-point. 

43.  For  a  tidal  boundary  on  the  east  (or  north),  a  special  formulation 
of  the  momentum  equation  at  the  last  internal  U- face  is  required: 


ImvPlmtx. j  “  ^A.lmmx  ~  . Immx^lmax. j 

The  sweep  proceeds  from  the  westernmost  S-point  to  this  17-point. 


(6-40) 


44.  A  river  boundary  condition  (RBC)  allows  flow  into  or  out  of  a 
computational  grid.  Being  a  flow  condition,  the  river  boundary  condition  is 
applied  at  a  U-  or  V-face  (Figure  6-12).  The  solution  proceeds  from  the  next 
internal  S-point  to  the  last  S-point.  For  a  river  boundary  on  a  west  (or 
south)  boundary  a  special  formulation  of  the  A*  in  the  continuity  equation  at 
the  first  S-point  is  required: 


m  Atl  -  AliUi 


(6-41) 


The  sweep  proceeds  from  this  S-point  to  the  last  S-point. 

45.  For  a  river  boundary  on  an  east  (or  north)  boundary,  a  special 
formulation  of  the  A*  in  the  continuity  equation  at  the  last  S-point  is 
required: 


A\.imtxUimax,J  +  .  lma^laax.  j  *  ~ 

The  sweep  proceeds  from  the  first  S-point  to  this  last  S-point. 


(6-42) 
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Uniform  flux  boundary  condition 

46.  A  uniform  flux  (or  zero  gradient)  boundary  condition  (UFBC)  implies 

that  flow  is  constant  across  such  a  boundary.  Similar  to  a  river  boundary, 
the  UFBC  is  applied  at  a  U-  or  V- face,  and  the  solution  begins  at  the  next 
internal  S-point  (Figure  6-13).  For  a  UFBC  on  a  west  (or  south)  boundary,  a 
special  formulation  of  the  in  the  continuity  equation  at  the  first  S- 

point  is  required: 

*  U,i  ♦  Au)  UUli)  «  A4,  (6-43) 

The  sweep  proceeds  from  this  S-point  to  the  last  S-point. 

47.  For  a  UFBC  on  an  east  (or  north)  boundary,  a  formulation  of  the  At 
in  the  continuity  equation  at  the  last  S-point  is  required: 

^3.  lrntx^  Uimtx.J  *  ^2,  = 

The  sweep  proceeds  from  the  first  S-point  to  this  last  S-point. 

SOLUTION  SWEEP 
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Land-water  boundaries 

48.  With  land-water  boundaries  (i.e.,  the  coastline),  water  velocities 
normal  to  the  land-water  interfaces  are  set  equal  to  zero  in  the  CLHYD  model. 
This  condition  means  that  the  boundary  is  closed  and  no  flow  is  permitted 
across  such  a  boundary.  Therefore,  this  model  lacks  the  capability  to 
simulate  flooding  and  drying  of  low-lying  areas.  This  capability  will  be 
added  with  a  future  release  of  CLHYD. 

49.  A  land-water  (closed)  boundary  is  applied  at  a  U-  or  V-face,  and 
the  solution  begins  at  the  next  internal  S-point.  For  a  land-water  boundary 
on  a  west  (or  south)  boundary,  a  special  formulation  of  the  Aa  in  the 
continuity  equation  at  the  first  S-point  is  required. 

AtiSi.j  *  AiiUt.i.j  -  (6‘45> 


The  sweep  proceeds  from  this  S-point  to  the  last  S-point. 

50.  For  a  land-water  boundary  on  an  east  (or  north)  boundary,  a  special 
formulation  of  the  A*  in  the  continuity  equation  at  the  last  S-point  is 
required: 

(6-46) 


*  ^i.lnax^lu 


Imax 


The  sweep  proceeds  from  the  first  S-point  to  this  last  S-point. 

Subgrid  barriers 

51.  Subgrid  barriers  (e.g.,  breakwaters)  are  treated  as  thin,  imperme¬ 
able  walls  that  extend  above  the  water  surface,  preventing  flow  from  one  cell 
to  the  next.  These  exposed  barriers  are  defined  along  specified  interior  cell 
faces  and  can  be  used  to  represent  any  nonovertopping  structure  in  a  study 
area.  They  can  also  be  used  to  represent  small  islands  when  using  a  coarse 
grid.  A  subsequent  release  of  CLHYD  will  include  submerged  and  overtopping 
barriers . 
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PART  III:  DEFINITION  OF  INPUT  DATA  FORMAT 


52.  The  input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  models  released  by  the  USAE  Hydrologic  Engineering 
Center.  It  is  the  intent  that  this  structure,  being  familiar  to  Corps 
personnel,  will  reduce  the  time  needed  to  learn  this  system.  The  general 
format  of  the  input  data  set  records,  where  a  record  refers  to  one  line  of 
data,  is  presented  below: 


a.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

b.  Field  1  (i.e.,  columns  1  through  8)  contains  a  mnemonic  identi¬ 
fication  label  that  describes  the  purpose  or  function  of  each 
record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right  justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  do  not  need  to  be  right-  or  left- 
justified. 

d.  Array  data,  such  as  depths,  are  read  with  DO  or  Implied  DO 
loops .  No  label  is  required  for  each  record  containing  array 
data.  However,  a  general  specification  record,  such  as 
BATHSPEC,  which  defines  bathymetric  attributes,  must  precede 
that  array. 

53.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution  or  bypassing  of  desired 
user-defined  operations,  such  as  saving  time-history  data. 

54.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  sira  .  tion  or  required  by  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies  per¬ 
formed  by  CERC.  Although  these  quantities  may  not  be  applicable  to  all 
studies,  they  can  serve  as  a  guide  when  selecting  alternative  values. 

55.  Default  values  are  processed  when  the  record  field  corresponding  to 
that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving  fields 
blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a  variable 
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being  assigned  a  value  of  zero.  These  variables  and  their  respective  default 
values  are  noted  in  Appendix  6-B.  The  following  discussion  pertains  to  the 
general  format  of  the  input  records  given  in  Appendix  6-B. 

56.  Each  record  is  presented  in  a  standardized  tabular  format  and  has 
as  its  heading  the  mnemonic  identification  label  or  name  with  a  brief  descrip¬ 
tion  of  its  function.  Following  its  name,  the  record  has  an  abbreviated  note 
documenting  whether  it  is  required  for  a  simulation.  These  abbreviations  have 
the  following  definitions. 

(Req)  Record  or  variable  is  required  for  each  simulation. 

(Opt)  Record  or  variable  is  optional.  Omitting  this  item 

results  in  either  the  default  value  being  used  or  the 
defined  operation  not  being  performed. 

(C-opt)  Record  or  variable  is  required  if  related  or  parent 
options  have  been  selected. 

For  example,  record  TIMESPEC,  presented  in  Appendix  6-B,  contains  the  note 
(Req) ,  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt),  meaning  this  record  is 
optional  and  is  used  only  when  changes  to  the  bathymetric  data  are  desired. 
Record  XSTRETCH  contains  the  note  (C-opt),  meaning  this  record  is  required 
only  if  a  stretched  Cartesian  grid  has  been  specified  on  the  GRIDSPEC  record. 

57.  Input  variables,  presented  in  column  2  of  each  table,  are  refer¬ 
enced  to  their  respective  record  fields  shown  in  column  1.  Generally,  data 
for  each  variable  occupy  a  single  8-column  data  field.  However,  variables 
assigned  titling  or  formatting  information  can  occupy  several  fields. 

58.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  column  3  and  can  be  real,  integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up 

to  16  characters 

Char*8  Alphanumeric  character  string  containing  up 

to  8  characters 

Integer  Integer  data 

Real  Real  (floating  point)  data 
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59.  Column  4  of  each  table  defines  whether  the  respective  variable  must 

be  assigned  a  value.  Abbreviations  listed  in  this  column  have  identical 
meanings  as  those  for  the  records.  Default  values  are  listed  in  column  5.  A 

blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 

assigned  a  default  value. 

60.  Column  6  of  each  table  lists  the  variables'  permitted  data  type  or 

all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 

specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+1  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 

61.  Variable  definitions  are  listed  in  table  column  7  of  each  table. 
Variables  whose  quantities  are  unit -dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  TMAX  is 
assigned  a  value  having  units  defined  by  variable  TUNITS.  Variables  defining 
input  data  units  and  the  record  on  which  they  reside  are  presented  below. 


Variable 

Record 

Definition 

BUNITS 

BATHSPEC 

bathymetry/topography  data 

FUN ITS 

FUNCTION 

tidal  and  discharge  boundary  data 

GUNITS 

GRIDSPEC 

numerical  grid  data 

SUNITS 

GENSPECS 

model  computations  and  output 

TUNITS 

TIMESPEC 

time -dependent  variables 

WUNITS 

WINDSPEC 

wind  velocity  data 
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PART  IV:  DISCUSSION  OF  INPUT  DATA  REQUIREMENTS 


62.  The  types  of  data  processed  by  CLHYD  are  extensive  and  encompass  a 
wide  range  of  possible  applications.  Since  each  application  is  unique,  the 
type  of  input  data  required  for  each  study  will  vary.  In  this  discussion  of 
model  input,  data  have  been  divided  into  six  categories  to  present  model  capa¬ 
bilities  and  data  requirements.  These  categories  are: 

3.  Model  control  specifications. 

b.  Grid  description. 

c.  Physical  characteristics. 

d.  Boundary  conditions. 

e.  Wind  field  specifications. 

f.  Output  specifications. 

63.  Table  6-2  presents  CLHYD  input  data  records  pertaining  to  each 
category.  A  record  refers  to  one  line  of  data,  and  each  record  begins  with  a 
mnemonic  character  string  to  identify  one  record  type  from  another.  Record 
format  and  detailed  specification  for  each  record  are  contained  in  Part  IV. 
While  reading  Part  IV,  the  user  will  find  it  beneficial  to  refer  to  Appen¬ 
dix  6-B,  where  descriptions  for  each  input  data  record  are  given. 

Model  Control  Specifications 

64.  Model  control  parameters  define  how  the  user  wants  to  control  the 
model's  execution.  Records  contained  in  this  category  include  GENSPECS, 
TIMESPEC,  STARTUP,  and  ADDTERMS . 

65.  Record  GENSPECS  is  used  to  specify  the  general  title  of  the 
simulation  (TITLE)  and  the  system  of  units  (SUNITS)  used  for  model  computa¬ 
tions  and  displaying  model  results.  Variable  names  are  typically  given  in 
parentheses.  In  addition  to  the  general  title,  other  input  data  records  have 
provisions  for  titles.  Although  this  information  is  optional,  it  can  be  very 
helpful  when  reviewing  a  series  of  simulations.  A  title  should  specifically 
state  data  set  attributes,  such  as  data  source  or  collection  date,  to  differ¬ 
entiate  it  from  data  used  in  other  simulations. 

66.  Model  output  is  presented  in  either  English  or  metric  units. 
However,  the  user  can  specify  a  different  system  of  units  for  the  input  data. 
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Table  6-2 


Incut  Data  Set  Records 


Category _  Eg<?ot#  Page 

Model  control  specifications  GENSPECS 

T1MESPEC 


STARTUP 

ADDTERMS 

Grid  description  GRIDSPEC 

GRIDCORN 

XSTRETCH 

YSTRETCH 

Physical  characteristics  BATHSPEC 

CHNGBATH 

FRICTION 

FRICTABL 

CHNGFRIC 

XBARRIER 

YBARRIER 


Boundary  conditions 


XBOUNDRY 

YBOUNDRY 

FUNCTION 

CNRECORD 

CONSTIT 

TERECORD 

TFRECORD 

TABELEV 

TAB FLOW 


Wind  field  specifications 


WINDSPEC 

TABWINDS 


Output  specifications  PRWINDOW 

RECGAGE 

RECSNAPS 

XRECRANG 

YRECRANG 


i 
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For  example,  the  user  can  supply  wind  velocity  data  having  units  of  either 
miles  per  hour,  feet  per  second,  meters  per  second,  or  knots.  CLHYD  will 
perform  the  necessary  conversion  to  place  the  input  data  into  the  system  of 
units  used  for  computations. 

67.  Record  TIMESPEC  controls  the  processing  of  all  time-related  vari¬ 
ables.  Variable  DT  defines  the  time -step  or  time  interval  between  consecutive 
flow  field  computations  and  has  units  of  seconds.  Variable  TUNITS  controls 
the  units  of  all  other  time -dependent  variables.  Valid  units  for  TUNITS  are 
hours ,  minutes ,  and  seconds . 

68.  For  meaningful  model  results,  the  selected  time-step  must  be 
consistent  with  the  Courant  criterion,  Cr  .  The  maximum  permissible  time- 
step  size  for  a  given  value  of  Ct  can  be  computed  from: 


Cr 


m 

Ax?  At 


(6-47) 


where  g  is  the  gravitational  acceleration,  Ax  is  the  dimension  of  the 
smallest  grid  cell  within  the  computational  domain,  H  is  the  depth  at  that 
cell,  and  At  is  the  time-step  size.  Experience  indicates  that  the  value  for 
CT  should  be  less  than  5.  Larger  values  of  the  Courant  number  may  be  permis¬ 
sible  at  a  distance  from  the  area  of  interest  within  the  computational  domain; 
however,  numerical  accuracy  will  be  affected. 

69.  Variable  IT1  defines  the  time-step  number  at  the  start  of  the 
simulation,  and  variable  IT2  defines  the  length  of  the  simulation  (in  time- 
steps) .  Typically,  a  simulation  begins  at  time-step  1  and  has  a  duration 
ranging  from  one  to  several  days.  This  duration  provides  the  hydrodynamic 
model  sufficient  time  in  which  to  develop  accurate  tidal  circulation  fields 
and  avoids  the  generation  of  numerical  instabilities  induced  by  instantaneous¬ 
ly  applying  forces  to  a  static  water  basin.  Additional  details  concerning 
duration  are  discussed  with  tidal  boundary  conditions. 

70.  Variable  NFREQ  specifies  the  frequency  at  which  numerical  gage 
time-history  data  (i.e.,  water  velocities  and  free  surface  elevations)  are 
saved  for  future  processing  by  the  post-processing  package  in  the  CMS. 
Numerical  gage  locations  (locations  for  which  time-histories  are  saved)  are 
selected  with  the  RECGAGE  record,  which  is  discussed  in  the  model  output 
specifications  section.  Variable  ITBRKINC  defines  the  time  interval  for 
saving  field  data  for  use  in  a  follow-up  simulation  (see  STARTUP  record). 
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71.  The  STARTUP  record  defines  the  flow  field  conditions  at  the  start 
of  a  simulation.  Normally,  the  initial  flow  field  is  assumed  to  be  static 
(i.e.,  water  surface  elevations  and  unit  flow  rates  are  set  to  zero). 

Although  this  assumption  may  not  be  entirely  correct,  it  is  often  necessary 
because  prototype  data  rarely  have  the  resolution  to  accurately  define  the 
flow  field  throughout  the  model  domain  at  the  start  of  a  simulation.  To  allow 
for  dampening  of  transients  associated  with  starting  from  static  initial 
conditions,  the  simulation  should  begin  several  hours  before  the  time  period 
of  interest. 

72.  Initial  conditions  can  also  be  supplied  from  .a  previous  simulation 
(SELEV  -  HOTSTART) .  These  simulations  must  be  sequential  in  time  since  the 
second  simulation  is  a  continuation  of  the  first.  When  initial  conditions  are 
supplied  from  a  previous  simulation,  the  second  simulation  is  referred  to  as  a 
"hotstart."  Slight  computational  inaccuracies  also  exist  for  hotstart 
conditions  due  to  data  round-off  incurred  by  storing  formatted  data.  These 
precision  errors  cause  transients  that  are  significantly  smaller  than  those 
generated  from  starting  with  static  conditions  and  can  be  minimized  by 
overlapping  the  simulations.  Overlapping  is  performed  by  saving  the  hotstart 
data  file  approximately  10  to  20  time-steps  before  the  end  of  the  first 
simulation.  The  second  simulation  is  then  run  with  this  hotstart  file.  When 
analyzing  model  results,  the  user  should  ignore  the  repeated  (overlapping) 
time-steps  in  the  second  simulation. 

73.  When  a  hotstart  is  selected,  variable  IT1  on  record  TIMESPEC  must 
be  set  to  the  time -step  when  the  desired  field  data  were  saved.  These  times 
are  printed  in  the  input  data  summary  file  of  the  preceding  run.  The  hotstart 
simulation  will  begin  at  time  1T1  and  end  at  time  IT2  +  IT1.  Therefore,  the 
user  should  not  incorporate  the  simulation  time  of  the  previous  run  into 
variable  IT2.  All  remaining  time  variables  should  reflect  the  change  in 
starting  time.  The  STARTUP  record  also  contains  variable  SECHO.  A  brief  or 
full  report  of  input  data  is  written  to  the  output  file  by  specifying  SECHO 
equal  to  SHORT  or  DETAILED,  respectively. 

74.  Record  ADDTERMS  must  reside  in  the  input  data  set  if  either  the 
inertial  or  dispersion  terms  are  to  be  computed  in  the  Navier-Stokes  calcula¬ 
tions.  Variable  ADVFLAG  is  set  to  either  NO  for  no  inertial  terms  or  YES  to 
include  the  inertial  terms.  Dispersion  is  set  with  variable  DIFFLAG  equal  to 
either  NO  for  no  dispersion  or  YES  for  dispersion.  The  value  of  the 
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dispersion  coefficient  is  defined  by  variable  AH  and  is  treated  as  a  constant 
in  CLHYD.  The  value  of  the  Coriolis  coefficient  is  defined  by  variable  COR  on 
record  ADDTERMS. 


Grid  Description 

75.  The  study  area  is  defined  in  the  model  via  a  computational  grid. 

The  grid  is  composed  of  rectilinear  or  curvilinear  cells,  where  each  cell  is 
assigned  a  two-dimensional  index.  The  first  index  (i)  corresponds  to  the 
x-coordinate ,  and  the  second  index  (j)  corresponds  to  the  y-coordinate .  The 
grid  index  system  is  presented  in  Figure  6-14.  All  flow  field  data,  such  as 
depths,  are  assigned  and  referenced  to  their  respective  grid  cells  with  this 
system.  Guidelines  for  developing  grids  are  discussed  in  Appendix  A  of  the 
CMS  User's  Manual. 

76.  CLHYD  permits  uniform  grids;  rectilinear  stretched  grids,  where 
successive  grid  cells  can  smoothly  vary  in  width;  or  general  curvilinear 
grids .  Procedures  for  constructing  a  grid  are  presented  in  documentation  of 
package  CMSGRID  (Appendix  A  of  the  CMS  User's  Manual).  CMSGRID  guidelines  for 
grid  generation  pertaining  to  hydrodynamic  models  are  therefore  useful  for 
CLHYD  applications . 

77.  Selection  of  grid  coordinate  systems  is  controlled  by  variable 
GRTYPE  on  record  GRIDSPEC.  A  uniform,  or  constant,  grid  cell  size  is  selected 
by  assigning  the  character  string  RECTANG  to  variable  GRTYPE,  whereas  string 
RSTRETCH  selects  a  stretched  rectilinear  grid.  If  the  stretched  grid  option 
is  selected,  record  GRIDSPEC  must  be  followed  by  a  set  of  XSTRETCH  and 
YSTRETCH  records  (Table  6-3).  These  records  are  generated  by  the  interactive 
grid  generation  program  MAPIT  contained  in  package  CMSGRID  and  can  be  placed 
directly  into  the  input  data  set  without  modification.  The  reader  can  refer 
to  Appendix  A  of  the  CMS  User's  Manual  for  more  information  on  XSTRETCH  and 
YSTRETCH . 

78.  A  general  curvilinear  grid  is  selected  by  assigning  the  character 
string  CURVILIN  to  variable  GRTYPE.  If  the  curvilinear  grid  option  is 
selected,  record  GRIDSPEC  must  be  followed  by  a  GRIDCORN  record.  This  record 
specifies  the  format  of  the  x-  and  y-coordinate  (XCT  and  YCT)  data  produced  by 
the  grid  generation  program  EAGLE;  the  data  directly  follow  the  GRIDCORN 
record.  (The  CMSGRID  package  will  contain  the  EAGLE  software.) 
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Figure  6-14.  Definition  of  coordinate  system 
and  grid  cell  convention 


79.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  computational  grid.  Valid  units  are  feet  and  meters.  CLHYD  will  convert 
the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 

Variables  ICELLS  and  JCELLS  specify  the  number  of  grid  cells  in  the  x-  and 
y-directions ,  respectively.  Variables  ALXREF  and  ALYREF  on  record  GRIDSPEC 
specify  a  grid's  overall  length  in  the  x-  and  y-directions,  respectively. 


Table  6-3 

Sample  XSTRETCH  and  YSTRETCH  Records 


XSTRETCH 

1 

4 

-.696333695 

.696333695 

.933460501 

XSTRETCH 

4 

9 

-6.69031772 

5.80606023 

.277821490 

XSTRETCH 

9 

19 

.143110486 

.710267924 

.770050578 

XSTRETCH 

19 

26 

.167892340 

.730987967 

.809764231 

YSTRETCH 

1 

17 

- . 500000000 

. 500000000 

1.00000000 

YSTRETCH 

17 

26 

.177832310 

.755987967 

.823454231 

The  variable  XMAP  is  assigned  the  value  of  the  map  scale  if  relative  map 
distances  were  used  in  generating  the  grid.  For  example,  a  map  with  a  scale 
of  1:80,000  is  used  to  generate  a  stretched  rectangular  grid.  If  the  physical 
map  distances  (i.e.,  distances  computed  using  the  appropriate  scaling)  are 
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used  to  generate  the  mapping  coefficients,  then  XMAP  is  1.0  because  no 
conversion  is  necessary.  However,  if  the  map  distances  (i.e.,  grid  distances 
measured  in  map  inches)  are  used  to  generate  the  mapping  coefficients,  then 
XMAP  must  be  6666.67  to  convert  map  inches  to  physical  distances  (e.g.,  in 
feet) . 


Physical  Characteristics 

80.  A  study  area's  physical  characteristics  include  its  (a)  topography/ 
bathymetry,  (b)  bottom  friction  coefficients,  and  (c)  if  applicable,  any 
barriers  or  obstructions  influencing  tidal  circulation  or  storm  surge  levels. 
Records  pertaining  to  each  of  the  above  topics  are  described  individually  in 
the  following  sections . 

Topography /bathymetry 

81.  Each  grid  cell  must  be  assigned  a  water  depth  or  land  elevation. 
Topography /bathymetry  data  are  referenced  to  an  arbitrary  datum.  Typically, 
the  map  datum  from  which  the  depths  are  taken  is  used.  Water  cells  are 
designated  by  positive  values,  whereas  land  cells  are  zero  or  negative  values. 

82.  One  BATHSPEC  record  is  required  for  defining  the  general  charac¬ 
teristics  of  the  topography /bathymetry  array  and  must  precede  this  array. 
Variable  BUNITS  defines  the  units  of  topography /bathymetry  data.  Valid  units 
are  feet,  meters,  or  fathoms.  The  input  sequence  for  reading  this  array  is 
controlled  by  variable  BSEQ.  Eight  options  for  the  input  sequence  are 
available  for  reading  the  array  data  and  are  documented  in  Table  6-4.  As  an 
example,  for  the  first  input  sequence  (Figure  6-15),  the  depths  are  read  along 
the  x- direction,  then  y  is  incremented  to  a  value  of  2,  and  again  the  sweep 
in  the  x-direction  takes  place.  This  procedure  is  repeated  until  the  entire 
array  is  read.  The  input  format  for  reading  this  array  can  be  selected  by  the 
user  with  variable  BFORM. 

83.  The  maximum  water  depth  is  specified  with  variable  DLIMIT,  and  any 
array  values  deeper  than  DLIMIT  are  set  to  DLIMIT  (in  BUNITS).  Grid-wide 
adjustments  to  land  elevations  contained  in  the  topography /bathymetry  array 
can  be  made  with  variable  LDATUM.  The  value  assigned  to  this  variable  is 
subtracted  from  all  land  cells  in  the  grid.  Positive  LDATUM  values  will 
increase  land  elevations,  whereas  negative  values  will  decrease  land  eleva¬ 
tions.  Similarly,  grid-wide  adjustments  to  water  depths  can  be  made  with 
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Table  6-4 


Input  Sequence  for  Array  Data 


No 

1 

Seauence 

Description 

XY 

1 

DO  1  J-l .JCELLS 

READ ( LUN , BFORM)  (VAR(I , J) , 1-1, ICELLS) 

2 

-XY 

2 

DO  2  J-l, JCELLS 

READ(LUN, BFORM)  ( VAR( I , J ) , I-ICELLS ,1,-1) 

3 

X-Y 

- 

3 

DO  3  J -JCELLS ,1,-1 

READ (LUN, BFORM)  (VAR(I ,J) , 1-1 , ICELLS) 

4 

-X-Y 

4 

DO  4  J -JCELLS ,1,-1 

READ (LUN, BFORM)  (VAR(I ,J) , I-ICELLS , 1 , -1) 

5 

YX 

5 

DO  5  1-1, ICELLS 

READ (LUN, BFORM)  (VAR(I,J) , J-l, JCELLS) 

6 

-YX 

6 

DO  6  1-1,1 CELLS 

READ (LUN, BFORM)  (VAR(I,J) , J-JCELLS , 1 , -1) 

7 

Y-X 

7 

DO  7  I-ICELLS, 1, -1 

READ (LUN, BFORM)  (VAR(I ,J) , J-l .JCELLS) 

8 

-Y-X 

8 

DO  8  I-ICELLS, 1,-1 

READ (LUN, BFORM)  (VAR(I ,J) .J-JCELLS , 1 , -1) 

Figure  6-15.  Input  sequence  -  option  1 
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variable  WDATUM.  The  value  assigned  to  this  variable  is  added  to  all  water 
cells.  Since  these  cells  have  positive  values,  positive  WDATUM  values  produce 
deeper  basins,  and  negative  WDATUM  values  produce  shallower  basins. 

84.  Changes  to  the  topography/bathymetry  array  can  also  be  made  to 
individual  cells,  or  a  group  of  cells  with  record  CHNGBATH.  This  record 
allows  the  user  to  quickly  change  values  assigned  to  the  bathymetry  array 
(using  variable  BATH)  without  editing  the  array  itself.  It  should  be  noted 
that  (a)  values  of  the  variable  BATH  on  the  CHNGBATH  record  are  assumed  to 
have  units  consistent  with  those  selected  for  bathymetry/topography  (i.e., 
variable  BUNITS  on  record  BATHSPEC) ,  and  (b)  LDATUM  and  WDATUM  are  not  applied 
to  cells  specified  with  record  CHNGBATH;  therefore,  the  effect  of  nonzero 
LDATUM  and  WDATUM  must  be  included  in  the  value  of  variable  BATH. 

85.  Variables  X1INDX  and  X2INDX  on  the  CHNGBATH  record  specify  the 
minimum  and  maximum  cell  numbers  in  the  x- direction,  respectively,  where  the 
bathymetry/topography  value  will  change.  Similarly,  variables  Y1INDX  and 
Y2INDX  on  the  CHNGBATH  record  specify  the  minimum  and  maximum  cell  numbers  in 
the  y-direction,  respectively,  where  the  bathymetry/topography  value  will 
change.  More  than  one  CHNGBATH  record  is  permitted. 

Bottom  friction  coefficient 

86.  Several  choices  are  available  for  specifying  bottom  friction 
coefficients.  Bottom  friction  coefficients  may  be  specified  as  constant 
Manning's  n  values  (FRDEF  -  CONSTANT),  as  individual  values  for  each  cell 
(FRDEF-TABULAR),  or  as  functions  of  depth/elevation  (FRDEF  -  VARYBATH) .  For 
the  constant  value  option,  separate  friction  coefficients  can  be  assigned  to 
land  and  water  cells.  Friction  coefficients  for  land  are  assigned  to  variable 
FRLAND,  and  coefficients  for  water  cells  are  specified  by  variable  FRWATR.  A 
coefficient  is  assigned  to  each  cell  based  on  its  topography /bathymetry  value 
at  the  start  of  a  simulation  and  will  remain  constant  throughout  the 
simulation. 

87.  The  tabular  friction  option  (FRDEF-TABULAR)  requires  friction 
coefficients  for  each  individual  cell.  The  friction  array  must  follow 
immediately  after  the  FRICTION  record.  The  input  sequence  for  reading  the 
friction  array  is  controlled  by  variable  FSEQ  on  record  FRICTION.  Eight 
options  for  the  input  sequence  are  available  for  reading  the  array  data  and 
are  documented  in  Table  6-4.  The  input  format  for  reading  the  friction  array 
can  be  selected  by  the  user  with  variable  FFORM  on  record  FRICTION. 
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88.  The  depth-variable  friction  option  requires  a  least  two  FRICTABL 
records,  which  must  follow  immediately  after  the  FRICTION  record  in  the  input 
data  set.  Each  FRICTABL  record  must  contain  a  depth/elevation  (FDEPTH)  and  a 
corresponding  friction  value  (FRICT)  for  creating  a  tabular  friction  function. 
Cells  with  a  water  depth  greater  than  or  equal  to  FDEPTH  are  assigned  a 
friction  value  of  FRICT.  Cells  whose  depths  are  deeper  than  the  deepest  depth 
entered  in  the  table  are  assigned  the  friction  coefficient  corresponding  to 
the  deepest  table  depth. 

89.  In  deep  water,  bottom  friction  has  a  negligible  effect  on  long-wave 
hydrodynamics.  Variable  FDMaX  on  record  FRICTION  defines  the  maximum  depth 
where  bottom  friction  influences  the  hydrodynamics.  It  is  provided  for 
reducing  computer  memory  requirements  when  the  depth-variable  option  is 
requested  and  has  a  default  value  of  300.0  ft. 

90.  Friction  coefficients  can  also  be  assigned  to  individual  cells,  or 
group  of  cells  with  record  CHNGFRIC.  Record  CHNGFRIC  overrides  the  above 
options  for  all  cells  entered  on  this  record.  This  feature  permits  the  user 
to  change  a  cell's  friction  coefficient  in  certain  areas,  such  as  rivers, 
where  parameters  differ  from  the  norm.  Variables  (X1INDX,  Y1INDX)  and 
(X2INDX,  Y2INDX)  define  the  "patch"  of  cells  where  friction  values  are  to  be 
changed.  More  than  one  CHNGFRIC  can  be  used  in  a  simulation.  These  records 
must  follow  FRICTION  and,  if  applicable,  FRICTABL  records. 

Barriers 

91.  Subgrid  barriers  refer  to  flow  field  obstructions,  such  as  breakwa¬ 
ters,  whose  widths  are  much  narrower  than  the  widths  of  adjacent  grid  cells, 
but  have  lengths  that  are  equal  to  or  greater  than  those  of  a  grid  cell. 
Barriers  are  treated  as  exposed,  impermeable  structures  in  model  CLHYD. 

92.  Barriers  that  prevent  or  impede  flow  in  the  x-direction  (i.e., 
perpendicular  to  the  x-axis)  are  specified  with  XBARRIER  records  (Figure  6- 
16).  A  barrier  for  a  particular  cell  is  defined  at  the  cell  face,  where  the 
velocity  is  also  defined.  Barrier  grid  locations  are  defined  with  variables 
BRP0S1,  BRP0S2,  and  BRP0S3.  Variable  BRPOSl  is  assigned  the  barrier's  grid 
cell  X- index,  and  variables  BRP0S2  and  BRP0S3  are  assigned  the  barrier's 
starting  and  ending  grid  cell  Y-indices,  respectively. 

93.  Similarly,  YBARRIER  records  define  those  barriers  that  prevent  or 
impede  flows  in  the  y-direction.  Variable  BRPOSl  is  assigned  the  barrier's 
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BRP0S1 


Figure  6-16.  Definition  of  XBARRIER  mad  YBARR1ER 


grid  cell  Y-index.  Variables  BRP0S2  and  BRP0S3  are  assigned  the  barrier’s 
starting  and  ending  grid  cell  If- indices. 

Boundary  Conditions 

94.  CLHYD  is  generally  applied  in  regions  where  at  least  one  grid 
boundary  lies  in  open  water.  For  example,  in  open  coast  regions,  the  seaward 
boundary  may  be  located  along  the  Continental  Shelf.  In  these  cases,  the  flow 
field  is  typically  driven  or  forced  by  prescribing  a  time -series  of  water 
surface  levels  along  this  boundary  throughout  a  simulation.  Regions  may  also 
contain  a  river  whose  flow  influences  local  circulation  patterns.  These  river 
flow  ratfes  can  be  specified  as  a  function  of  time. 

95.  To  encompass  as  many  modeling  scenarios  as  possible,  three  types  of 
open  boundary  conditions  are  incorporated  into  this  model  including: 

&.  Tidal  elevation. 

&.  Discharge. 

£.  Uniform  flux  condition 

Discussion  of  these  open  boundary  conditions  is  presented  in  three  parts. 
First,  an  overview  of  each  type  of  open  boundary  describes  its  application  and 
attributes.  Second,  input  data  requirements  for  defining  a  boundary's  grid 
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location  are  presented.  Third,  input  data  requirements  for  entering  time- 
series  data  are  described. 

Overview  of  open  boundary  conditions 

96.  With  the  tidal  elevation  boundary  condition,  the  flow  field  is 
driven  by  specifying  the  water  surface  elevations  as  a  function  of  space  and 
time  along  a  grid's  outer  boundary.  Water  surface  elevations  are  measured 
relative  to  the  topography /bathymetry  datum  and  can  be  supplied  from  tidal 
constituent  parameters  or  tabulated  data. 

97.  Two  options  are  available  for  specifying  the  spatial  distribution 
of  data  along  a  boundary.  The  first  option  applies  a  spatially  constant 
elevation  function  across  a  boundary  segment  where  each  cell  in  the  segment 
acts  in  unison,  having  identical  water  surface  elevations  at  each  time -step. 
This  option  is  normally  applied  along  a  grid's  lateral  boundary  (i.e., 
perpendicular  to  the  shoreline)  in  areas  of  deep  water.  It  can  also  be  used 
along  a  seaward  boundary  if  no  significant  phase  or  elevation  differences 
occur  along  this  segment. 

98.  The  second  option  is  a  spatially  variable  elevation  forcing  boun¬ 
dary  where  separate  time -series  functions  are  specified  at  each  end  of  a 
boundary  segment.  Elevations  for  each  cell  within  the  boundary  segment  are 
obtained  by  linearly  interpolating  the  two  forcing  functions  (at  each  time- 
step)  .  This  option  is  typically  applied  along  the  grid's  seaward  boundary.  A 
boundary  can  be  treated  as  one  continuous  segment,  or  as  several  segments. 

99.  Discharge  boundary  conditions  can  be  specified  at  any  interior  grid 
cell  face.  An  error  message  will  be  printed  and  execution  terminated  if  this 
boundary  condition  is  specified  at  the  edge  of  the  computational  grid. 
Furthermore,  depths  on  each  side  of  the  boundary  cell  faces  must  be  greater 
than  zero,  signifying  water  cells.  Discharges  are  required  to  have  units  of 
flow  per  unit  width  (i.e.,  cubic  feet/second/foot  or  cubic  meters/second/ 
meter),  and  flow  trajectories  are  referenced  relative  to  the  grid  axes. 
Positive  discharge  rates  define  flows  directed  in  the  positive  x-  or 
y-directions ,  whereas  negative  discharge  rates  define  flows  directed  in  the 
negative  x-  or  y-direction. 

100.  A  uniform  flux  boundary  condition  is  similar  to  a  river  discharge 
boundary  condition  in  that  a  flux  is  applied  at  the  boundary  cell  face. 
However,  the  flux  through  the  cell  face  is  computed  internally  by  the  model, 
as  opposed  to  a  user-defined  flux.  This  boundary  condition  assumes  that  the 
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flux  through  the  boundary  cell  face  equals  the  flux  through  the  opposing  cell 
face . 

101.  Since  the  uniform  flux  boundary  condition  does  not  drive  a  flow 
field,  its  application  is  limited.  However,  there  are  two  situations  where  it 
can  be  applied.  First,  it  can  be  applied  across  the  lateral  boundaries  near 
the  shoreline  (Figure  6-17).  Tidal  signals  generated  from  constituents,  which 
are  normally  prescribed  as  a  forcing  function  along  the  seaward  boundary, 
should  not  be  used  in  this  reach  because  bottom  friction  effects  attenuate  the 
tidal  signal.  Hence,  forcing  a  tidal  signal  in  this  reach  may  not  accurately 
depict  the  physical  processes  occurring  within  the  study  area. 

102.  Second,  the  uniform  flux  boundary  condition  may  be  applicable  to 
steady-state,  storm  surge  analyses  of  lakes.  However,  wind  must  be  the  only 
driving  force  causing  surge,  and  resulting  seiches  cannot  be  simulated  with 
this  boundary  condition. 

103.  Because  the  uniform  flux  boundary  condition  provides  an  estimate 
of  the  actual  flow  entering/exiting  the  grid,  its  use  will  introduce  error 
into  the  flow  field  solution.  Bottom  friction  effects  can  dampen  these 
inaccuracies,  ensuring  accuracy  of  results  in  the  area  of  interest,  if  the 
uniform  flux  boundaries  are  placed  a  suitable  distance  away  from  the  area  of 
incerest.  Generally,  this  distance  ranges  from  1.5  to  2.0  times  that  distance 
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Figure  6-17.  Uniform  flux  boundary  condition 
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measured  from  the  shoreline  to  the  seaward  boundary  (if  it  is  located  at  the 
Continental  Shelf) . 

Spatial  description  of  open  boundaries 

104.  Each  distinct  open  boundary  must  be  declared  by  either  an  XBOUNDRY 
or  a  YBOUNDRY  record.  Record  XBOUNDRY  defines  a  boundary  that  induces  or 
forces  flow  in  the  x-direction  (i.e.,  boundary  is  perpendicular  to  the  x-axis) 
(Figure  6-18).  Conversely,  a  YBOUNDRY  record  defines  a  boundary  that  is 
perpendicular  to  the  y-axis. 

105.  Boundary  types  are  declared  on  records  XBOUNDRY  and  YBOUNDRY  with 

variable  BNDTYP  and  can  be  assigned  any  of  the  three  options  previously 
discussed:  (a)  spatially  constant  tide  boundaries  are  selected  with  character 

string  CONSTELV,  (b)  spatially  variable  tide  boundaries  are  chosen  with  string 
INTRPELV,  (c)  spatially  constant  discharge  boundaries  are  selected  with  string 
CONSTDIS,  and  (d)  uniform  flux  boundaries  are  selected  with  string  UNIFLUX. 

106.  This  model  employs  a  staggered  grid  cell  system  where  water 
surface  levels,  x-direction  velocities,  and  y-direction  velocities  are  defined 
at  different  locations  on  a  cell.  These  positions  were  defined  in  Figure  6-4. 
Elevation  are  referenced  relative  to  a  cell's  center,  and  river  discharge 
boundaries  are  specified  along  cell  faces. 

107.  Boundary  grid  positions  are  defined  with  variables  BNP0S1,  BNPOS2, 
and  BNP0S3.  For  XBOUNDRY  records,  variable  BNP0S1  is  assigned  the  boundary's 
X- index,  whereas  variables  BNP0S2  and  BNP0S3  are  assigned  the  Y- indices  of  the 
starting  and  ending  cells,  respectively  (Figure  6-18).  For  YBOUNDRY  records, 
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Figure  6-18.  Definition  of  XBOUNDRY  and  YBOUNDRY 
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variable  BRPOSl  is  assigned  the  boundary's  Y- index,  and  variables  BRP0S2  and 
BRP0S3  are  assigned  the  X- indices  of  the  starting  and  ending  cells,  respec¬ 
tively.  Boundaries  can  be  identified  by  assigning  each  one  a  boundary  name 
with  variable  BNDNAM  on  the  XBOUNDRY  or  YBOUNDRY  records. 

Time -series  description  of  open  boundaries 

108.  Time -series  data  are  required  for  driving  the  flow  field  for  all 
of  the  boundary  options:  (a)  spatially  constant  elevation,  (b)  spatially 
variable  elevation,  and  (c)  spatially  constant  discharge  boundary  options. 
XBOUNDRY  and  YBOUNDRY  variable  BNDFN1  (for  all  three  options)  and  BNDFN2  (for 
spatially  variable  elevation  boundaries  only)  define  which  group  of  time- 
series  data  is  to  be  used  to  drive  the  boundary,  and  correspond  to  the 
function  index  number  assigned  to  variable  FUNNO  on  record  FUNCTION.  For 
example,  an  application  may  have  a  spatially  variable  elevation  boundary  and 
two  spatially  constant  elevation  boundaries  (Figure  6-19).  This  application 
would  require  two  FUNCTION  records  (one  at  each  end  of  the  spatially  variable 
boundary)  to  define  the  time  series  at  two  locations.  These  values  are  also 
used  along  the  spatially  constant  boundaries. 
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Figure  6-19.  Example  showing  use  of  BNDFN1 , 
BNDFN2 , and  FUNNO  variables 
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109.  The  FUNCTION  record  is  required  for  time-series  data  and  defines 
the  character  of  the  forcing  function  driving  the  boundary.  Variable  FUNTYP 
on  record  FUNCTION  is  used  to  determine  if  the  boundary  is  forced  with 
harmonic  constituents  (HARMCNST) ,  tabular  elevation  data  (TABELEVS),  or 
tabular  discharge  data  (TABFLOWS) .  Variable  FUNITS  defines  the  units  used  for 
the  given  elevations  or  flows.  The  forcing  function  can  be  adjusted  by 
shifting  it  in  time  (phase  shift)  or  in  the  vertical  (datum  shift) ,  or  by 
multiplying  the  entire  time -series  by  an  adjustment  factor.  Variables  FSHIFT, 
FDATUM,  and  FMULT  on  record  FUNCTION,  respectively,  are  used  to  perform  these 
tasks.  The  forcing  function  can  be  gradually  spline-fit  from  initial 
conditions  (usually  zero)  to  the  given  function  value  over  the  time  period 
assigned  to  variable  FEATHR  defined  on  record  FUNCTION. 

Harmonic  constituents 

110.  A  boundary  driven  with  harmonic  constituents  (FUNTYP  -  HARMCNST) 
requires  at  least  two  records  to  follow  the  FUNCTION  record:  one  CNRECORD 
record  and  at  least  one  CONSTIT  record.  First,  the  CNRECORD  record  specifies 
the  physical  coordinates  and  timing  associated  with  a  constituent  forcing 
function.  The  calendar  date  (variables  RYEAR,  RMONTH,  and  RDAY) ,  time  at  the 
start  of  the  simulation  (variable  RHOUR) ,  and  the  west  longitude  of  the  grid 
cell  where  the  forcing  function  is  applied  (RLONG)  are  specified  on  record 
CNRECORD.  Dates  and  times  can  be  referenced  to  Greenwich  Mean  Time  (GMT)  or 
local  time.  GMT  is  assumed  if  the  longitude  (RLONG)  equals  zero,  and  nonzero 
longitude  values  signal  a  local  time  specification.  CNRECORD  also  contains 
variable  RNAME  for  specifying  a  record  name  for  the  forcing  function. 

111.  One  CONSTIT  record  is  needed  for  each  constituent  used  in  generat¬ 
ing  the  tiine-series  data.  Variable  CNAME  on  record  CONSTIT  defines  which 
constituents  are  selected.  Table  6-5  provides  a  list  of  the  37  constituents 
available.  A  maximum  of  37  constituents  can  be  selected  (requiring  37  CONSTIT 
records)  and  are  referenced  with  the  naming  convention  developed  by  the 
National  Ocean  Survey  (NOS) .  Variable  CNAME  on  record  CONSTIT  is  used  to 
select  any  of  the  constituents  listed  in  Table  6-5.  Other  data  entered  on 
this  record  include  the  constituent's  amplitude  (CAMP)  and  epoch  (CEPOCH) . 
Tabular  elevation  time  series 

112.  Tabular  elevation  data  can  be  used  to  specify,  or  force,  a 
boundary.  CLHYD  can  access  components  of  program  TIDEGEN  in  package  CMSUTIL 
(Appendix  B  of  the  CMS  User's  Manual )  to  internally  compute  the  tabular 
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Table  6-5 

List  of  Available  Constituents 


NOS  Name 

_ Description _ 

M2 

Semidiurnal 

S2 

Semidiurnal 

N2 

Semidiurnal 

K1 

Diurnal 

M4 

Shallow-water 

quarter  diurnal 

01 

Diurnal 

M6 

Shallow-water 

sixth  diurnal 

MK3 

Shallow-water 

terdiurnal 

S4 

Shallow-water 

quarter  diurnal 

MN4 

Shallow-water 

quarter  diurnal 

NU2 

Semidiurnal 

S6 

Shallow-water 

sixth  diurnal 

MU  2 

Semidiurnal 

2N2 

Semidiurnal 

001 

Diurnal 

LAMBDA2 

Semidiurnal 

SI 

Diurnal 

Ml 

Diurnal 

J1 

Diurnal 

MM 

Long-period 

SSA 

Long-period 

SA 

Long-period 

MSF 

Long-period 

MS 

Long-period 

RH01 

Diurnal 

Q1 

Diurnal 

T2 

Semidiurnal 

R2 

Semidiurnal 

2Q1 

Diurnal 

PI 

Diurnal 

2SM2 

Shallow-water 

semidiurnal 

M3 

Terdiurnal 

L2 

Semidiurnal 

2MK3 

Shallow-water 

terdiurnal 

K2 

Semidiurnal 

M8 

Shallow-water 

eighth  diurnal 

MS4 

Shallow-water 

quarter  diurnal 

elevation  time-history  data  from  tidal  constituents.  Each  tabular  tide 
boundary  requires  a  TERECORD  to  precede  the  actual  water  surface  elevation 
data.  The  elevation  data  can  be  given  at  even  (constant)  time  increments 
(RRINT  -  Real  number)  or  at  user-specified  (irregular)  times  (RRINT 
-  IRREGINT) . 
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113.  Constant  time- Interval  data  are  entered  as  a  one -dimensional  array 
immediately  following  record  TERECORD.  The  time  interval  between  entries  is 
specified  with  variable  RRINT  (in  TUNITS)  on  record  TERECORD.  The  total 
number  of  tabular  elevation  data  entries  in  the  one -dimensional  array  is 
specified  with  variable  RENT.  The  user  must  also  specify  which  of  the  array 
elements  corresponds  to  the  start  of  the  simulation  with  variable  RSTART. 
Typically,  this  element  is  the  first  value  in  the  array.  However,  this 
variable  must  be  updated  for  hotstart  simulations.  Variable  RFORM  is  used  to 
specify  the  format  for  reading  the  one -dimensional  array,  and  variable  RNAME 
is  used  for  naming  the  tabular  tide  record. 

114.  For  irregularly  spaced  (in  time)  tabular  tide  data,  one  TERECORD 
and  a  series  of  TABELEV  records  are  required.  Variable  RRINT  on  record 
TERECORD  is  set  to  IRREGINT  for  irregularly  spaced  (in  time)  tide  data.  The 
remaining  variables  on  this  record  are  ignored  with  this  option. 

115.  One  TABELEV  record  is  needed  for  each  tabular  tide  entry.  The 
elevation  (FMAG  in  FUNITS)  and  time  of  occurrence  (FHR,  FMIN,  FSEC  in  hours, 
minutes,  and  seconds)  are  required  on  each  TABELEV  record.  Elevations  are 
linearly  interpolated  at  those  time-steps  occurring  between  entries;  there¬ 
fore,  at  least  two  TABELEV  records  are  required.  The  first  TABELEV  record 
must  specify  the  elevation  at  or  before  the  start  of  the  simulation,  whereas 
the  last  TABELEV  record  must  specify  the  elevation  at  or  after  the  end  of  the 
simulation. 


Tabular  river  discharge  time  series 

116.  River  discharge  boundary  conditions  can  be  specified  at  any 
interior  grid  cell  face.  An  error  message  will  be  printed  and  execution 
terminated  if  this  boundary  condition  is  specified  at  an  outer -boundary  face. 
Furthermore,  depths  on  opposite  sides  of  the  river  boundary  cell  face  must  be 
greater  than  zero,  signifying  a  water  cell.  Discharges  are  required  to  have 
units  of  flow  per  unit  width  (i.e.  cubic  feet/second/foot  or  cubic 
meters/second/meter) . 

117.  Each  river  discharge  boundary  function  requires  one  TFRECORD 
(analogous  to  the  tabular  tide  function  record  (TERECORD)  discussed  previous¬ 
ly)  to  precede  the  flow  data.  The  flow  data  can  be  given  at  even  (constant) 
time  increments  (RRINT  -  real  number),  or  at  user-specified  (irregular)  times 
(RRINT  -  IRREGINT). 


118.  Constant  time-interval  data  are  entered  as  a  one -dimensional  array 
immediately  following  record  TFRECORD .  The  time  interval  between  entries  is 
specified  with  variable  RRINT  (in  TUNITS)  on  record  TFRECORD.  The  total 
number  of  tabular  flow  data  entries  in  the  one -dimensional  array  is  specified 
with  variable  RENT.  The  user  must  also  specify  which  of  the  array  elements 
corresponds  to  the  start  of  the  simulation  with  variable  RSTART.  Typically 
this  element  is  the  first  value  in  the  array.  However,  this  variable  must  be 
updated  for  hotstart  simulations.  Variable  RFORM  is  used  to  specify  the 
format  for  reading  the  one -dimensional  array,  and  variable  RNAME  is  used  for 
naming  the  tabular  flow  record. 

119.  For  irregularly  spaced  (in  time)  tabular  flow  data,  one  TFRECORD 
and  a  series  of  TABFLOW  records  are  required.  Variable  RRTMT  on  record 
TFRECORD  is  set  to  IRREGINT  for  irregularly  spaced  (in  time)  flow  data.  The 
remaining  variables  on  this  record  are  ignored  with  this  option. 

120.  One  TABFLOW  record  is  needed  for  each  tabular  flow  entry.  The 
flow  rate  (FMAG  in  FUNITS)  and  time  of  occurrence  (FHR,  FMIN,  FSEC  in  hours, 
minutes,  and  seconds)  are  required  on  each  TABFLOW  record.  Flow  rates  are 
linearly  interpolated  at  those  time-steps  occurring  between  entries;  there¬ 
fore,  at  least  two  TABFLOW  records  are  required.  The  first  TABFLOW  record 
must  specify  the  flow  rate  at  or  before  the  start  of  the  simulation,  whereas 
the  last  TABFLOW  record  must  specify  the  flow  rate  at  or  after  the  end  of  the 
simulation. 

Uniform  flux  boundary  condition 

121.  The  uniform  flux  boundary  condition  (UFBC)  is  similar  to  a  river 
discharge  boundary  condition  in  that  a  flux  is  applied  at  the  boundary  cell 
face.  However,  the  flux  through  the  cell  face  is  computed  internally  by  the 
computer  as  opposed  to  specifying  the  flux  for  a  river  boundary.  This 
boundary  condition  assumes  that  the  flux  through  the  boundary  cell  face  is 
equal  to  the  flux  through  the  opposing  cell  face. 

122.  Since  the  UFBC  does  not  drive  a  flow  field,  its  application  is 
limited.  Therefore,  care  must  be  taken  in  applying  it.  Selecting  an  inappro¬ 
priate  reach  (length)  of  the  boundary  may  lead  to  erroneous  results.  The  user 
should  test  the  sensitivity  of  choice  by  trying  other  segment  lengths  that 
band  the  chosen  reach. 
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123.  CLHYD  can  simulate  hydrodynamics  influenced  by  uniform,  non- 
uniform,  steady,  and  time-varying  wind  fields.  However,  wind-field  calcula¬ 
tions  are  only  performed  if  record  WINDSPEC  and  related  records  reside  in  the 
input  data  set.  Uniform  (spatially  and  temporally  constant)  wind  fields  are 
specified  by  assigning  character  string  UNIFSTRS  or  UNIFSPED  to  variable 
WNTRVL  on  record  WINDSPEC.  The  WINDSPEC  record  is  followed  by  one  TABWINDS 
record  specifying  the  x-  and  y-components  of  the  constant  wind  stress  or  speed 
(Table  6-6). 

124.  Nonuniform  (spatially  variable)  wind  fields  are  specified  by 
assigning  character  string  SPVRSTRS  or  SPVRSPED  to  variable  WNTRVL  on  record 
WINDSPEC.  The  WINDSPEC  record  is  followed  by  one  TABWINDS  record  specifying 
the  sequence  (TSEQ)  and  format  (TWFORM)  of  the  wind- stress  or  wind- speed 
arrays,  similar  to  the  bathymetry  sequence  (BSEQ)  and  format  (BFORM)  (see 
Figure  6-15).  The  TABWINDS  record  is  then  followed  by  the  wind-stress  or 
wind- speed  arrays. 

125.  Time -variable,  spatially  constant  wind  fields  are  specified  by 
assigning  character  string  TVRUNISP  or  TVRUNIST  to  variable  WNTRVL  on  record 
WINDSPEC.  The  WINDSPEC  record  must  be  followed  by  at  least  two  TABWINDS 
records  that  specify  the  x-  and  y-components  of  the  wind  stress  or  speed  at 
specific  times  during  the  simulation. 

126.  Wind  fields  that  vary  in  time  and  space  are  specified  by  assigning 
character  string  TSPVRSTR  or  TSPVRSPD  to  variable  WNTRVL  on  record  WINDSPEC. 
The  WINDSPEC  record  is  followed  by  at  least  two  TABWINDS  records,  and  each 
TABWINDS  record  is  followed  by  wind- stress  or  wind- speed  arrays. 

127.  For  the  time-variable  uniform  wind  options,  one  TABWINDS  record  is 
typically  entered  for  each  hour  of  the  simulation.  (More  frequent  data 
occasionally  exist.)  The  model  will  then  linearly  interpolate  to  obtain  wind- 
speed  and  direction  values  at  the  time  interval  specified  by  WINTRP  on  record 
WINDSPEC.  It  should  be  noted  that  WINTRP  must  be  assigned  a  value  that  is  an 
integer  multiple  of  the  time -step  DT. 

128.  Variable  WUNITS  declares  the  system  of  units  for  wind  magnitudes. 
Valid  units  are:  (a)  miles/hour,  selected  with  character  string  MPH;  (b) 
feet/second,  chosen  with  FPS ;  (c)  meters/second,  specified  with  MPS ;  and 

(d)  knots,  selected  with  KNOTS. 


Table  6-6 

Options  for  Wind- Field  Specifications 


Cases  1  and  2  Constant  wind  field  with  respect  to  time  and  space 


WINDSPEC 

UNIFSTRS 

MPH 

WINTRP 

WIND  DATA  NAME 

or 

UNIFSPED 

TABWINDS 

TAUX 

TAUY 

Cases  3  and  4  Spatially  variable  wind  field 


WINDSPEC 

SPVRSTRS 

MPH 

WINTRP 

or 

SPVRSPED 

TABWINDS 

WIND  DATA  NAME | 
TSEQ 


TWFORM| 


(Array  of  TX1) 
(Array  of  TY1) 


Cases  5  and  6  Time-variable  wind  field 


WINDSPEC 

TVRUNISP 

MPH 

WINTRP 

WIND  DATA  NAME 

or 

TVRUNIST 

TABWINDS 

IDAY(l) 

IHOUR(l) 

TAUX(l) 

TAUY ( 1 ) 

TABWINDS 

IDAY(2) 

IH0UR(2) 

TAUX(2) 

TAUY ( 2 ) 

TABWINDS 

IDAY(3) 

IH0UR(3) 

TAUX(3) 

TAUY ( 3 ) 

Cases  7  and  8  Time  and  spatially  variable  wind  field 

WINDSPEC 

TSPVRSTR 

MPH 

WINTRP 

WIND  DATA  NAME  I 

or 

TSPVRSPD 

1 

TABWINDS 

I DAY ( 1 ) 

IHOUR(l) 

TSEQ 

(Array  of  TX1) 
(Array  of  TY1) 

TABWINDS 

1  IDAY(2) 

IH0UR(2) 

(Array  of  TX1) 
(Array  of  TY1) 

TWFORM 


129.  Strong  winds  instantaneously  applied  to  a  static  water  basin,  such 
as  at  the  start  of  a  simulation,  will  generate  extraneous  water  oscillations 
that  can  lead  to  the  model  becoming  unstable  or  can  remain  in  the  model 
solution  for  a  significant  portion  of  a  simulation.  These  problems  can  be 
alleviated  by  gradually  increasing  wind  magnitudes  from  zero  at  the  start  of 
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the  simulation,  to  the  actual  magnitude  several  hours  into  the  simulation. 

This  task  can  be  accomplished  by  adjusting  wind  magnitudes  entered  on  the 
TABWINDS  records . 

130.  All  TABWINDS  records  must  immediately  follow  the  WINDSPEC  record, 
Furthermore,  times  entered  on  these  records  must  correspond  to  the  simula¬ 
tion's  starting  time  defined  by  variable  IT1  on  record  TIMESPEC.  The  first 
TABWINDS  record  must  occur  no  later  than  the  start  of  the  simulation.  For  the 
time-variable  option,  the  last  TABWINDS  record  must  occur  no  earlier  than  the 
end  of  the  simulation. 

131.  For  example,  if  the  simulation  begins  at  0  hr  0  min  and  has  a 
duration  of  36  hr,  the  first  TABWINDS  record  must  specify  wind  conditions 
occurring  at  (or  before)  0  hr  0  min,  and  the  last  record  must  occur  at  36  hr 
0  min  (or  later) .  Should  the  simulation  be  continued  with  the  hotstart 
option,  all  times  entered  on  the  TABWINDS  record  are  referenced  to  the 
original  starting  time.  Assuming  the  hotstart  begins  at  hour  36  and  has  a 
duration  of  24  hr,  the  first  TABWINDS  record  must  have  as  its  time  no  later 
than  36  hr  0  min.  The  last  TABWINDS  record  must  have  as  its  time  60  hr  0  min, 
(or  later) . 


Output  Specification 

132.  CLHYD  provides  several  options  for  displaying  output,  including: 
(a)  numerical  gage  time-histories  at  selected  grid  cells  (e.g.,  elevations, 
wind,  and/or  water  velocities) ,  (b)  wind  or  water  velocity  vector  fields  at 
user- specif ied  times  during  a  simulation,  and  (c)  an  output  listing  containing 
an  input  data  summary  and  a  printout  of  field  arrays  (e.g.,  free  surface 
elevations,  water  velocities,  wind  velocities,  bathymetry).  CMSMODEL  will 
prompt  the  user  to  provide  a  name  for  each  specific  output  file  (i.e,  hydro¬ 
graph  file  name  for  RECGAGE  data,  snapshot  file  name  for  field  array  (REC- 
SNAPS)  data).  These  data  files  can  be  used  as  input  to  hydrodynamic  models  as 
well  as  wave  hindcast  models.  Data  can  be  displayed  in  either  tabular  or 
graphical  form  with  the  post-processing  package  CMSPOST  discussed  in  Appendix 
C  of  the  CHS  User’s  Manual. 

133.  The  output  listing  containing  a  summary  of  the  input  data  set  is 
generated  for  every  simulation.  Error  and  warning  diagnostic  messages  are 
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also  contained  in  this  listing.  A  sample  output  listing  containing  a  summary 
of  the  input  data  set  is  presented  in  Figure  6-20. 

134.  Each  input  record  is  summarized  in  tabular  form  with  a  heading 
containing  its  record  identification  label  followed  by  a  brief  description  of 
that  record's  function.  A  table  is  composed  of  each  variable's  name,  a 
description  of  that  variable  (including  its  units,  when  applicable),  and  an 
error  diagnostic  note. 

135.  CLHYD  contains  error  diagnostic  features  that  inspect  an  input 
data  set  for  possible  errors.  These  features  include:  (a)  comparing  an 
inputted  value  against  a  range  of  quantities  that  are  representative  for  that 
variable,  (b)  checking  for  misspelled  character  data,  and  (c)  checking  for 
missing  data.  The  error  diagnostic  note  can  be  assigned  one  of  three  charac¬ 
ter  strings,  which  are:  (a)  "FATAL"  for  errors  where  the  model  cannot  execute 
given  the  value  supplied,  (b)  "WARN"  for  data  that  are  outside  the  range  of 
values  typically  selected  for  that  variable,  and  (c)  a  null  string  for 
instances  where  an  error  condition  has  not  been  identified.  Although  this 
model  contains  error  diagnostic  capabilities,  the  user  should  thoroughly 
inspect  the  input  data  summary  to  ensure  that  the  data  are  correct. 

136.  Field  arrays  (e.g.,  free  surface  elevations,  water  velocities, 
wind  velocities,  bathymetry)  are  printed  along  with  the  input  data  summary  by 
including  one  or  more  PRWINDOW  records.  Variable  WPRVAR  on  record  PRWINDOW  is 
used  to  specify  which  field  arrays  are  to  be  printed  (e.g.  WPRVAR  =  E  for 
water  surface  elevations).  The  user  can  control  printing  of  field  arrays 
through  the  course  of  a  simulation  by  specifying  the  starting  (WPRSTR)  and 
ending  (WPREND)  time-steps,  together  with  the  time  interval  (WPRINT) ,  at  which 
the  data  will  be  printed.  Furthermore,  the  user,  can  specify  printing  of 
subgrid  regions  (or  windows)  as  opposed  to  the  entire  grid,  if  he  so  chooses. 
This  is  done  by  specifying  the  x-  and  y-boundaries  of  a  subgrid  region  with 
variables  WXCEL1 ,  WXCEL2 ,  WYCEL1 ,  and  WYCEL2 . 

137.  Gage  time -histories  of  field  arrays  are  saved  with  record  RECGAGE. 
One  RECGAGE  record  is  required  for  each  desired  output  location  where  the 
field  array  data  are  to  be  saved.  A  maximum  of  120  gages,  each  containing  up 
to  1,000  points,  can  be  processed.  All  gage  time-histories  are  stored  in  one 
file  and  are  processed  by  programs  HYDADD,  HYDLST,  and  HYDPLT  in  package 

CMS POST. 
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COASTAL 


HQDELIN8  SYSTEM  (CMS):  CLHYD  .  VERSION 

-  CLHYD  SWEAT  ION  NO.  2;  TIDE  NITH  NONLINEAR  TERMS 


1  .  0 


•mm  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AM)  GEJCRAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  •  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SUN ITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

t 

*****  GRIDSPEC  CARD:  SPECIFICATION  OF  T)C  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

botes:  • 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

WTES: 

GRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTAN6 

t 

GUNITS 

SYSTEM  OF  UNITS  USES  FOR  THE  GRID 

ENB.ISH 

XCELL 

NICER  OF  GRID  CELLS.  X  DIRECTION 

75 

• 

YCELJL 

NICER  OF  GRID  COLS.  Y  DIRECTION 

30 

ALXREF 

TOTAL  LENGTH  IN  X  DIRECTION 

37500.00 

• 

ALYREF 

TOTAL  LENGTH  IN  Y  DIRECTION 

30000.00 

TIHESPEt  CARO:  SPECIFICATION  OF  COMPUTATIONAL  TIME  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  • 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

DELT 

COCUTATIONAL  TI*  STEP  (SECONDS) 

30.0 

1UNITS 

THC  UNITS  FOR  ALL  HPUT  VARIABLES 

Stines 

IT1 

TIMES1EP  AT  START  OF  MOSEL  SIMULAT10  1 

IT2 

TOTAL  NICER  OF  TIHESTEPS  SIMULATED 

2520 

ICREB 

TIICSTEP  INTERVAL  TD  SAVE  GAGE  DATA 

12 

DUCTS 

TIICSTEP  INTERVAL  TO  SAVE  HOTSTARTS 

0 

•••••  ADO TERMS  CARD:  SPECIFICATION  OF  ADDITIONAL  TERNS 

IN  GOVERNING  EOUATIONS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  • 

VARIABLE 

DESCRIPTION  DF  USAGE: 

VALUE: 

NOTES: 

ADVFIAB 

GOVERNS  USE  OF  AOVECTION  TERNS 

YES 

• 

DIFFLAG 

GOVERNS  USE  OF  DIFFUSION  TERMS 

YES 

DIFDOF 

DIFFUSION  COEFFICIENT 

5.0000 

t 

CORIOLIS 

CORIOLIS  COEFFICIENT 

0.0000 

•*•••  STARTUP  CM®:  SPECIFICATION  OF  INITIAL  COW1ITIONS 

VARIABLE 

DESCRIPT  KM  OF  USAGE: 

VALUE: 

NOTES:  • 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SE LEV 

INITIAL  HATER  SURFACE  ELEVATION 

4.05 

SECHD 

AMOUNT  OF  INPUT  DATA  TO  BE  PRINTED 

SHORT 

IHOURO 

HOUR  AT  START  OF  SIMULATION 

0 

IMINO 

MINUTE  AT  START  OF  SIIUATION 

0 

ISECO 

SECOND  AT  START  OF  SITUATION 

0 

SNAME 

NAME  OF  STARTUP  CUCITI0N5 

••••»  HYDROGRAPH  AND  VELOCITY  ICASUSCNTS:  2  GAGES 

GAGE  GAGE -POSITION  VELOCITY-MEASUREItNT 
NUMBER:  X  Y  NOTES:  T>PE:  NOTES:  GAGE  NAME: 


1  IV  16  INLET  GAGE 

2  42  15  OCEAN  GAGE 


•«.«  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 

AREA  •  STARTING  ENDING  STARTING  ENDING  •  TIMES  TD  PRINT  .'SECONDS  K  •  VARIABLE  FIRD 


Figure  6-20.  Sample  output  listing 
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138.  Variables  1ST  and  JST  on  record  RECGAGE  define  the  grid  location 
where  field  arrays  are  saved.  The  time  interval  at  which  these  data  are 
stored  is  controlled  by  variable  NFREQ  on  record  TIMESPEC. 

139.  Record  RECSNAPS  allows  the  user  to  store  wind  and  water  velocity 
data  for  generating  vector  plots.  The  stored  data  can  also  be  used  as  input 
to  other  models.  Data  can  be  saved  at  regular  time  intervals  (SNPTYP  - 
INTERVAL),  at  specific  time-steps  during  a  simulation  (SNPTYP  -  TIMES),  or 
both.  For  data  storage  at  regular  time  intervals,  SNPSTR  defines  the  time- 
step  at  which  data  storage  is  to  begin,  SNPEND  defines  the  time -step  at  which 
data  storage  is  to  end,  and  SNPINT  is  the  regular  time-step  interval  at  which 
data  storage  occurs.  For  data  storage  at  user-specified  times,  one  RECSNAPS 
record  is  required  for  each  time  (SNPTIM)  at  which  a  snaps’  ->t  is  to  be 
recorded.  More  than  one  RECSNAPS  record  can  be  used,  and  up  to  100  snapshots 
can  be  saved  in  a  file.  These  data  can  be  processed  with  programs  SNAPCON, 
SNAPLST,  and  SNAPVEC,  which  reside  in  package  CMSPOST. 

140.  Records  XRECRANG  and  YRECRANG  allow  the  user  to  save  data  describ¬ 
ing  discharges  across  arbitrary  transects.  These  data  allow  the  user  to  check 
flow  through  various  tributaries  or  to  determine  the  tidal  prism.  One  record 
is  required  for  each  desired  transect.  A  maximum  of  120  ranges,  each  contain¬ 
ing  up  to  1,000  points,  can  be  processed.  All  range  time-histories  are  stored 
in  one  file  and  are  processed  by  programs  HYDADD,  HYDLST,  and  HYDPLT  in 
package  CMSPOST. 

141.  Similar  to  barriers  and  boundaries,  variable  RP0S1  defines  the  x- 
cell  position  (for  XRECRANG)  or  the  y-cell  position  where  data  are  to  be 
recorded.  Variables  RP0S2  and  RP0S3  define  the  range,  or  extent,  of  the 
recording  range  location.  For  XRECRANG,  records  RP0S2  and  RP0S3  indicate  the 
y-extent,  and  for  YRECRANG,  records  RP0S2  and  RP0S3  indicate  the  x-extent. 

The  time  interval  at  which  these  data  are  stored  is  controlled  by  variable 
NFREQ  on  record  TIMESPEC.  RNAME  is  used  to  name  the  range  data. 
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PART  V:  ILLUSTRATIVE  EXAMPLES 


142.  Three  sets  of  illustrative  examples  are  included  in  this  section 
to  demonstrate  CLHYD's  capabilities.  The  grid  geometry  for  the  first  set  of 
examples  is  the  same;  however,  the  forcing  functions  vary.  Thi-;  set  of 
examples  was  also  presented  with  model  WIFM,  which  is  another  long-wave 
hydrodynamic  model  in  CMS.  The  second  set  of  examples  involves  a  series  of 
tests  using  orthogonal  curvilinear  grids.  The  last  example  involves  the 
application  of  CLHYD  at  Indian  River  Inlet,  Delaware. 

143.  The  75-  by  30-cell  study  area  used  in  the  first  set  of  examples 
consists  of  an  open  ocean  and  back-bay  area  joined  through  an  inlet,  and  two 
barrier  islands  (Figures  6-21  and  6-22).  The  inlet  is  protected  with  two 
jetties.  A  small  island  situated  in  the  back  bay  is  also  simulated.  The 
first  set  of  examples  includes:  (a)  a  tidal  forcing  simulation  without 
advection  and  dispersion  terms  or  feathering,  (b)  a  tidal  forcing  simulation 
starting  at  slack  water  and  with  nonlinear  terms,  (c)  simulation  (a)  with  the 
inclusion  of  a  steady  wind  field,  and  d)  simulation  (a)  with  the  inclusion  of 
river  inflow  into  the  back-bay  area.  Although  the  examples  show  individual 
applications  of  wind  and  discharge  forcing  functions,  they  can  be  combined  and 
applied  simultaneously. 


Figure  6-21.  Computational  grid  for  four  examples 
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Tidal  Forcing  Simulation 


144.  The  tidal  forcing  simulation  was  run  on  the  75-  by  30-cell  grid 
described  previously  (Figure  6-22)  The  grid's  spatial  resolution  was  500  ft 
in  the  on-offshore  (x-)  direction  anc  1,000  ft  in  the  longshore  (y-)  direction 
for  an  overall  grid  size  of  37,500  by  30,000  ft.  It  should  be  noted  that  the 
grid  resolution  between  jetties  is  usually  much  finer  (more  cells)  than  what 
is  used  in  these  examples,  in  order  to  properly  represent  inlet  hydrodynamics. 
The  water  depth  in  the  back  bay  was  held  to  a  constant  depth  of  10  ft.  The 
water  depth  varied  from  30  ft  along  the  shoreline  cells  to  300  ft  at  the 
offshore  boundary.  The  duration  of  the  simulation  was  24  hr. 

145.  A  tidal  forcing  function  was  implemented  along  the  offshore 
boundary  (Tl)  using  harmonic  constituent  data  ^M2  tide,  amplitude  -  3.97  ft, 
epoch  -  199.02  deg).  Elevation  values  were  spatially  constant  along  the 
seaward  boundary.  Thus,  all  the  seaward  boundary  cells  acted  as  one  entity, 
having  the  same  time-series  of  water  surface  fluctuations.  The  tidal  forcing 
function  at  the  shoreline  (T2;  was  identical  to  the  offshore  t*dal  forcing 
function,  except  for  a  10-min  phase  lag.  Elevation  values  along  the 


n  n 


Figure  6-22.  Computational  area  for  tidal - forcing  simulations 
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lateral  boundary  cells  were  interpolated  from  the  two  forcing  functions  (T1 
and  T2)  applied  at  the  ends  of  the  boundary  segment.  Tide  gages  were  placed 
at  two  locations:  in  the  inlet  (cell  (19,16))  and  in  the  open  ocean  (cell 
(42,15))  to  monitor  hydrograph  data. 

146.  The  input  data  set  is  given  in  Table  6-7  and  is  discussed  below. 
The  location  and  type  of  boundary  forcing  functions  are  specified  with 
XBOUNDRY  and  YBOUNDRY  records.  FUNCTION,  CNRECORD,  and  CONSTIT  records  give 
specifics  about  the  two  tidal  forcing  functions,  such  as  the  harmonic  constit¬ 
uent^)  used,  amplitude(s) ,  epoch(s),  and  time(s)  of  occurrence.  XBARRIER  and 
YBARRIER  records  were  used  to  denote  the  two  jetties.  Record  BATHSPEC  is  used 
to  describe  the  bathymetric  data,  and  RECGAGE  records  show  the  locations  of 
the  two  recording  gages.  The  PRWINDOW  record  was  used  to  print  elevations  and 
velocities  for  the  entire  grid  to  the  output  summary  file  at  1-hr  time 
intervals  (120  time-steps)  (Table  6-8). 

147.  The  simulation  was  run  for  2,880  time-steps  (24  hr),  and  elevation 
and  velocity  values  were  saved  every  12  time-steps  at  the  two  recording  gage 
locations.  At  the  conclusion  of  the  simulation,  the  hydrograph  data  were 
examined  to  check  model  results  (Figures  6-23  and  6-24).  The  water  surface 
elevation  at  the  inlet  gage  shows  a  slight  spurious  oscillation  at  the  start 
of  the  simulation,  but  the  oscillation  diminishes  within  one  tidal  cycle. 

This  slight  "start-up"  error  can  be  virtually  eliminated  by  applying  the  tidal 
forcing  function  more  gradually  (feathering)  or  by  starting  the  simulation  at 
slack  water.  (See  variable  SELEV  on  record  STARTUP.) 

148.  The  water  surface  elevations  at  the  open  ocean  gage  oscillate  with 
a  very  slight  start-up  error  as  previously  described.  The  velocities  at  the 
open  ocean  gage  travel  in  the  x  (90  deg)  and  -x  (-90  deg)  directions  with  a 
magnitude  of  approximately  1.3  ft/sec.  The  direction  is  dictated  by  the  fact 
that  the  forcing  function  at  the  offshore  boundary  is  spatially  constant  and 
the  bathymetric  contours  are  straight  and  parallel  to  the  shoreline.  The 
velocities  through  the  inlet  travel  diagonally  across  the  grid  (45  and 

-135  deg)  as  directed  by  the  jetties.  The  peak  magnitude  is  approximately 
2.5  ft/sec. 

149.  In  summary,  an  M2  tide  was  simulated  in  a  typical  study  environ¬ 
ment  to  show  CLHYD's  ability  to  predict  water  surface  fluctuations  and 
velocities  in  response  to  the  forcing  function. 
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Table  6-7 


GENSPECS  CLHYD  SIMULATION  NO.  1:  TIDE  WITHOUT  FEATHERING  ENGLISH 


TIMESPEC 

30. 

SECONDS 

1 

2880 

12 

GRIDSPEC 

ENGLISH 

75 

30 

37500. 

30000. 

1. 

PRWINDOW 

120 

E V 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1 

BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1 

BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

18 

14 

14 

2.5 

XB1 

XBARRIER 

20 

15 

15 

2.5 

XB2 

XBARRIER 

22 

16 

16 

2.5 

XB3 

XBARRIER 

19 

17 

17 

2.5 

XB4 

XBARRIER 

21 

18 

18 

2.5 

XB5 

YBARRIER 

14 

17 

17 

2.5 

YB1 

YBARRIER 

15 

18 

19 

2.5 

YB2 

YBARRIER 

16 

20 

21 

2.5 

YB3 

YBARRIER 

17 

22 

23 

2.5 

YB4 

YBARRIER 

17 

17 

18 

2.5 

YB5 

YBARRIER 

18 

19 

20 

2.5 

YB6 

YBARRIER 

19 

21 

23 

2.5 

YB7 

BATHSPEC 

YX 

(8X.9F8.1) 

1 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

2 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 

-99.0 

3 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 

4 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 
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Table  6-8 


Output  Summary  for  the  Tidal -Forcing  Simulation 


COASTAL  HODELINS  SYSTEM  (CHS):  CLHYO  .  VERSION  1.0 

-  CLHYO  SIMULATION  NO.  l:  TIDE  WITHOUT  FEATHERING  - 

HIM  6ENSPECS  CARD:  SPECIFICATION  OF  TITU  (*0  SE)£RAL  SYSTEM  OF  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  VfWIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 

SUNITS  UNITS  SYSTEM  USED  IN  COMPUTATIONS  ENGLISH  » 


*****  6RIDSPEC  C0ID:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  6RID  USED 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  •  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

6RTYPE 

I  CELL 
ALXREF 

TYPE  OF  FINITE-DIFFERENCE  BRIO 
NUMBER  OF  GRID  CELLS.  X  DIRECTION 
TOTAL  LENGTH  IN  X  DIRECTION 

RECTANG 

75 

37500.00 

•  SUNITS 

•  YCELL 

•  ALYREF 

SYSTEM  OF  (KITS  USED  FOR  THE  GRID 
NUffiER  OF  GRID  CELLS.  Y  DIRECTION 
TOTAL  LENGTH  IN  Y  DIRECTION 

ENGLISH 

30 

30000.00 

•MM  TIHE5PEC  CARD:  SPECIFICATION  OF  COMPUTATIOfW.  TIME  UNITS 


VARIABLE  DESCRIPTION  OF  USAGE: 


W1UE:  NOTES:  »  VARIABLE  DESCRIPTION  OF  USAGE: 


VALUE:  NOTES: 


CELT  COHUTATIONAL  TIME  STEP  {SECONDS)  30.0 
ITI  T1MESTEP  AT  START  OF  MODEL  SIMULATE  I 
ITREO  TIHESTEP  INTERVAL  TO  SAVE  GAGE  BATA  12 


»  TUNITS  TIME  UNITS  FOR  ALL  ItfUT  VARIABLES  SECONDS 

•  IT2  TOTAL  NUMBER  OF  TIMESTEPS  SIMULATED  2880 

•  DTNOTS  TIMESTEP  INTERVAL  TO  SAVE  HOTSTARTS  0 


MM*  HYDROGRAPH  AND  VELOCITY  IOSUREIENTS:  2  GAGES 

GAGE  GAGE-POSITION  VELQCITY-tEASUREXENT 
NUMBER:  X  Y  NOTES:  TYPE:  NOTES:  GAGE  NAfC: 


1  19  16  WET  GAGE 

2  42  IS  OCEAN  GAGE 


mm*  PRINTING  OF  FIELD  ARRAY  VARIABLES:  I  AREAS 


AREA  » 

STARTING 

ENDING 

STARTING 

EXDINS 

• 

TlltS  TO  PRINT 

(SECOMfi  >: 

• 

VARIABLE  FIELD 

NUMBER  * 

X  CELL 

X  CELL 

Y  CELL 

Y  CELL  NOTES: 

*  START  AT 

06)  AT 

INTERVAL  NOTES: 

• 

ARRAYS  TO  PRINT:  N0TE5: 

'  "  • 

I  * 

X=  1 

X=  75 

V*  t 

Y=  30 

*  - 

• 

0 

2880 

120 

• 

EV 

•*••  BATHSPEC  CARD:  SPECIFICATION  OF  BATHYItTRY/TOFOGRAPHY  - 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  •  VARIABLE 

DESCRIPTION  OF  USAGE: 

value:  notes: 

BUNITS 

NOATUM 

OLIMIT 

SYSTEM  OF  UNITS  FOR  DEPTH  DATA 
DATUM  FOR  NATER  DEPTHS 

MAXIUJM  DEPTH  AU.OHED 

FEET 

0.000 

6000.0 

«  BSE8 
•  LDATUH 
«  BFORM 

READ  SEQUENCE  FOR  DEPTH  DEC* 

DATUM  FOR  LAND  ELEVATIONS 

FORMAT  OF  DEPTH  DATA 

YI 

0.000 

(8X.9F8.1) 

NUMBER  OF  ELEVATION  CHANGES  =  0 
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Figure  6-23.  Elevation  plots  for  the  tidal-forcing  simulation 


CURVE 


Figure  6-24.  Velocity  plots  for  the  tidal-forcing  simulation 


Tidal-Forcing  Simulation  with  Nonlinear  Terms 


150.  The  tidal-forcing  simulation  was  repeated  with  the  addition  of 
records  ADDTERMS  and  STARTUP.  Record  ADDTERMS  is  used  to  include  advective 
and  dispersion  terms  in  the  governing  equations.  The  nonlinear  terms  are  more 
difficult  and  time-consuming  to  simulate,  but  provide  a  more  realistic 
representation  of  the  hydrodynamics  in  the  study  area,  particularly  at  the 
inlet  where  velocity  gradients  are  greatest.  Record  STARTUP  is  used  to  raise 
the  entire  water  surface  to  the  peak  flood  elevation.  At  peak  flood  (or  ebb) , 
velocities  reach  zero,  and  the  initial  and  boundary  conditions  are  consistent. 
The  "start-up"  error  observed  in  the  last  example  can  be  reduced  considerably 
with  this  procedure.  Table  6-9  shows  the  addition  of  records  ADDTERMS  and 
STARTUP  to  the  input  data  set.  In  addition,  record  PRWINDOW  was  modified  to 
print  elevations  to  the  output  file  at  the  conclusion  of  the  simulation  only 
(Table  6-10). 

151.  The  elevation  and  velocity  hydrographs  at  the  inlet  and  open  ocean 
gages  are  presented  in  Figures  6-25  and  6-26.  The  elevations  do  not  exhibit 
the  degree  of  spurious  oscillation  observed  in  the  first  example.  Starting 
the  simulation  at  slack  water  considerably  reduced  the  start-up  error.  The 
velocities  also  appear  to  be  different  from  the  velocities  in  the  first 
example.  The  magnitude  of  the  velocity  at  the  open  ocean  gage  is  no  longer 
equal  on  the  ebb  and  flow  because  of  the  nonlinear  terms.  However,  the 
direction  of  the  velocity  at  the  open  ocean  gage  does  not  change  significantly 
with  the  inclusion  of  nonlinear  terms. 


Wind-Induced  Setup  Simulation 


152.  In  the  third  test  simulation,  a  uniform  wind  was  blown  in  the 
shoreward  direction  for  the  duration  of  the  simulation  (Figure  6-27).  (The 
tidal  forcing  functions  from  the  first  simulation  were  also  included.)  The 
wind  gradually  increased  over  the  first  hour,  until  a  maximum  sustained  wind 
speed  of  40  knots  was  reached  (Figure  6-28).  Table  6-11  shows  the  addition  of 
the  WINDSPEC  and  TABWINDS  records  to  the  input  data  set  to  specify  the 
gradually  applied  wind  field.  These  records  are  used  to  describe  the  magni¬ 
tude  and  direction  of  the  wind  field  at  designated  times  during  the  simula¬ 
tion.  The  PRWINDOW  record  was  used  to  print  elevations  at  hours  12  and  24  of 
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Table  6-9 

Input  Data  Set  for  the  Tidal-Forcing  Simulation  vlth  Nonlinear _ Terms 


GENS PECS 

CLHYD  SIMULATION  NO. 

2:  TIDE 

WITH  NONLINEAR  TERMS 

ENGLISH 

TIMESPEC 

30. 

SECONDS 

1 

2520 

12 

GRIDSPEC 

ENGLISH 

75 

30 

37500. 

30000. 

1. 

PRWINDOW 

2520 

E 

STARTUP 

4.048 

ADDTERMS 

YES 

YES 

5.0 

0.0 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYI NTRPELV 

1 

17 

75 

2 

1 

BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1 

BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

5.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

5.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

18 

14 

14 

2.5 

XB1 

XBARRIER 

20 

15 

15 

2.5 

XB2 

XBARRIER 

22 

16 

16 

2.5 

XB3 

XBARRIER 

19 

17 

17 

2.5 

XB4 

XBARRIER 

21 

18 

18 

2.5 

XB5 

YBARRIER 

14 

17 

17 

2.5 

YB1 

YBARRIER 

15 

18 

19 

2.5 

YB2 

YBARRIER 

16 

20 

21 

2.5 

YB3 

YBARRIER 

17 

22 

23 

2.5 

YB4 

YBARRIER 

17 

17 

18 

2.5 

YB5 

YBARRIER 

18 

19 

20 

2.5 

YB6 

YBARRIER 

19 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(8X.9F8.1) 

1 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

2 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0 

-99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 

-99.0 

3 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 

4 

-99.0 

-99.0 

-99.0 

-99.0 

■99.0 

-99.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

10.0 

-99.0 

-99.0 
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Table  6-10 


Output  Summary  for  the  Tidal -Forcing  Simulation  with  Nonlinear  Terms 


COASTAL  MODELING  SYSTEM  (CHS):  CLHYD  .  VERSION  1.0 

-  CLHYD  SIMULATION  NO.  2:  TIDE  KITH  NOM.DCAR  TERMS  - 


«♦•«*  SENSPECS  CARD:  SPECIFICATION  OF  TITLE  AM)  SEJCRAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

«  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

t 

GRIDSPEC  CARD:  SPECIFICATION  OF  TOE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

GRTYPE 

XCELL 

ALXREF 

TYPE  OF  FINITE-DIFFERENCE  GRID 
NUMBER  OF  GRID  CELLS.  X  DIRECTION 
TOTAL  LENGTH  IN  X  DIRECTION 

RECTAN6 

75 

37500.00 

«  SUNITS 

•  YCELL 

*  ALYREF 

SYSTEM  OF  (WITS  USED  FOR  THE  GRID 
NUMBER  OF  GRID  CELLS,  Y  DIRECTION 
TOTAL  LENGTH  IN  Y  DIRECTION 

ENGLISH 

30 

30000.00 

*****  TIHESPEC  CARD:  SPECIFICATION  OF  COFUTATIONAL  THE  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

DELT 

IT1 

NFREQ 

COMPUTATIONAL  TIIE  STEP  (SECONDS)  30.0 
TI1ESTEP  AT  START  OF  MODEL  SINJLATIO  1 
TI1ESTEP  INTERVAL  TO  SAVE  GAGE  DATA  12 

•  TUNITS 

•  IT2 

•  DTHOTS 

TIME  UNITS  FOR  ALL  ItfUT  VfWIABlES 
TOTAL  NUMBER  OF  TIHESTEPS  SIMULATED 
TIItSTEP  INTERVAL  TO  SAVE  HDTSTARTS 

SECONDS 

2520 

0 

««*••  ADDTERHS  CARD:  SPECIFICATION  OF  ADDITIONAL  TERMS 

IN  GOVERNING  equations 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

notes: 

AOVFLAG 

D1FC0F 

GOVERNS  USE  OF  ADVECTIGN  TERMS 
DIFFUSION  COEFFICIENT 

YES 

5.0000 

*  DIFFLAG 

•  CORIOLIS 

GOVERNS  USE  OF  DIFFUSION  TERMS 
CORIOLIS  COEFFICIENT 

YES 

0.0000 

•»•*•  ST(«TUP  CARD:  SPECIFICATION  OF  INITIAL  CONDITIONS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  NOTES: 

SELEV 

INITIAL  HATER  SURFACE  ELEVATION 

4.05 

•  SECHO 

AMOUNT  OF  INPUT  DATA  TO  BE  PRINTED 

SHORT 

IH0UR0 

HOUR  AT  START  OF  SIMULATION 

0 

•  IHINO 

MINUTE  AT  START  OF  SIMULATION 

0 

ISECO 

SECOND  AT  START  OF  SIMULATION 

0 

•  SNMC 

NAME  OF  STARTUP  CONDITIONS 

*****  HYDROGRAPH  AND  VELOCITY  MEASUREMENTS:  2  SAGES 


GAGE 

NUMBER: 


GAGE-POSITION 
X  Y  NOTES: 


VELOCITY-MEASUREMENT 
TYPE:  NOTES: 


GAGE  NAME: 


I?  14 
42  15 


INLET  SA6E 
OCEAN  GAGE 


**••»  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 


AREA  •  STARTIN6  ENDING  STARTING  ENDING 


TINES  TO  PRINT  (SECONDS  i: 


•  VARIABLE  FIELD 


Figure  6-25.  Elevation  plots  for  the  tidal- forcing  simulation  with  nonlinear  terms 


6-26.  Velocity  plots  for  the  tidal -  forcing  simulation  with  nonlinear  terms 


T2  T1 


x 

#  Tldol  Forcing  Function 
■  Recording  Gog*  Location 


Figure  6-27.  Computational  grid  for  wind- induced  setup  simulation 

the  simulation  (Table  6-12).  The  inlet  and  ocean  hydrographs  are  presented  in 
Figures  6-29  and  6-30  and  are  discussed  below. 

153.  As  the  simulation  proceeds,  the  wind  continues  to  blow  shoreward 
causing  a  setup  to  develop.  From  Figure  6-29,  it  appears  that  the  elevations 
are  the  same  for  the  tide  with  wind  as  with  the  tide  alone.  However,  there  is 
a  slight  rise  in  the  mean  water  surface  elevation.  The  magnitude  of  the 
velocity  at  the  open  ocean  gage  shows  a  larger  peak  ebb  value  than  peak  flood 
value.  This  larger  peak  ebb  value  is  caused  by  the  tide  flow  and  the  free 
surface  gradient  created  by  the  onshore  wind  being  in  the  same  or  opposite 
directions,  respectively.  (The  water  surface  slope  created  by  the  onshore 
wind  works  against  the  onshore  propagation  of  the  tide  wave.) 
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Figure  6-28.  Wind  magnitude  and  directions  for  wind-induced  setup  simulation 


Table  6-11 


Input  Data  Set  for  the  Wind- Induced  Setup  Simulation 


GENSPECS 

CLHYD  SIMULATION  NO. 

3:  TIDE 

WITH  WIND 

ENGLISH 

TIMESPEC 

30. 

SECONDS 

1 

2880 

12 

GRIDSPEC 

ENGLISH 

75 

30  37500. 

30000.  1. 

PRWINDOW 

1440 

EV 

WINDSPECTVRUNISP 

KNOTS 

TABWINDS 

0 

0 

0.0 

0.0 

TABWINDS 

0 

6 

-1.0 

0.0 

TABWINDS 

0 

10 

-2.0 

0.0 

TABWINDS 

0 

16 

-4.0 

0.0 

TABWINDS 

0 

20 

-6.0 

0.0 

TABWINDS 

0 

26 

-10.0 

0.0 

TABWINDS 

0 

42 

-24.0 

0.0 

TABWINDS 

0 

50 

-31.0 

0.0 

TABWINDS 

0 

54 

-34.0 

0.0 

TABWINDS 

0 

58 

-36.4 

0.0 

TABWINDS 

1 

2 

-38.4 

0.0 

TABWINDS 

1 

6 

-39.4 

0.0 

TABWINDS 

1 

8 

-40.0 

0.0 

TABWINDS 

24 

0 

-40.0 

0.0 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1  BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1  BDRY2 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

18 

14 

14 

2.5 

XB1 

XBARRIER 

20 

15 

15 

2.5 

XB2 

XBARRIER 

22 

16 

16 

2.5 

XB3 

XBARRIER 

19 

17 

17 

2.5 

XB4 

XBARRIER 

21 

18 

18 

2.5 

XB5 

YBARRIER 

14 

17 

17 

2.5 

YBl 

YBARRIER 

15 

18 

19 

2.5 

YB2 

YBARRIER 

16 

20 

21 

2.5 

YB3 

YBARRIER 

17 

22 

23 

2.5 

YB4 

YBARRIER 

17 

17 

18 

2.5 

YB5 

YBARRIER 

18 

19 

20 

2.5 

YB6 

YBARRIER 

19 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(8X.9F8.1) 

1 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0  -99.0 

-99.0  -99.0 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0  -99.0 

-99.0  -99.0 

-99.0 

-99.0 

-99.0 

-99.0 

99.0 

-99.0  -99.0 

-99.0  -99.0 

-99.0 

-99.0 

-99.0 
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Table  6-12 

ip  Wind- Induced  Setup  Simulation 


Output  Summary  for  th 


COASTAL  HODELINS  SYSTEM  (CMS):  CLHYD  .  VERSION  1.0 


CLHYD  SIMULATION  NO.  3:  TIDE  WITH  WIND 


♦MM  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AND  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

value: 

NOTES:  •  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COWUTATIONS 

ENGLISH 

• 

*****  GRIDSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  * 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SRTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANG 

SUNITS 

SYSTEM  OF  UNITS  USED  FOR  TIC  GRID 

ENGLISH 

XCELL 

NUHBER  OF  GRID  CELLS,  X  DIRECTION 

75 

YCELL 

NUHBER  OF  GRID  CELLS.  Y  DIRECTION 

30 

ALXREF 

TOTAL  LEN6TH  IN  X  DIRECTION 

37500.00 

ALYREF 

TOTAL  LENGTH  IN  Y  DIRECTION 

30000.00 

••»**  TIMESPEC  CARD:  SPECIFICATION  OF  COMPUTATIONAL  TIME  UNITS 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES:  « 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

notes: 

DELT 

COMPUTATIONAL  TIME  STEP  (SECONDS) 

30.0 

DJNITS 

TIME  UNITS  FOR  ALL  INPUT  VARIABLES 

SECONDS 

IT1 

timesdep  at  stlwt  of  model  situatio  s 

IT> 

TOTAL  NUMBER  OF  TIMESTEFS  SIMULATED 

2880 

tfREQ 

TINESTEP  INTERVAL  TO  SAVE  6AGE  DATA 

12 

DTHOTS 

TIMES TEF  INTERVAL  TO  SAVE  HOTSTfKTS 

0 

•MM  HYDROGRAPH  AND  VELKITY  MEASUREMENTS:  1  GASES 

GAGE  6A6E -POSITION  VELOCITY -TCASUREHENT 
NUMBER:  X  Y  NOTES:  TYPE:  NOTES:  GAGE  NAK: 


1  19  14  INLET  GAGE 

2  42  15  OCEAN  GAGE 


•MM  PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  MEAS 


AREA 

• 

STARTIN6 

ENDING 

STARTING 

ENDING 

»  TIMES  TO  PRINT 

(SECONDS  ): 

• 

VARIABLE  FIELD 

NUMBER 

• 

X  CELL 

X  CELL 

Y  CELL 

Y  CELL  notes: 

♦  START  AT  END  AT 

INTERVAL  NOTES: 

• 

ARRAYS  TO  PRINT: 

1 

• 

X=  1 

X=  75 

Y=  1 

Y=  30 

♦  0  2830 

1*40 

• 

EV 

mm*  MINDSPEC  CARD:  SPECIFICATION  OF  THE  WIND  FIELD  - 


NOTES: 


VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  VARIAH.E  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 


WTYPE  FORM  OF  WIND  FIELD  DATA  INPUT  •  WNTAVL  HIND  FIELD  CONSTANT  OR  VARIABLE '  TVPUNISP 

WUNITS  WIND  SPEED  UNITS  KNOTS  *  PUNITS  WINDFIELO  NAME 


•••*  BATHSPEC  CARO:  SPECIFICATION  OF  BATHYMETRY/ - 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  •  <-S'ABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 


I 


Figure  6-29.  Elevation  plots  for  the  wind- induced  setup  simulation 


Figure  6-30.  Velocity  plots  for  the  wind-induced  setup  simulation 


River  Discharge  Simulation 

154.  In  the  fourth  simulation,  a  river  flowing  into  the  back-bay  area 
at  a  rate  of  1,250  ft3/sec  was  simulated  (Figure  6-31).  (The  tidal  forcing 
functions  from  the  first  simulation  were  also  included.)  The  river  inflow 
gradually  increased  over  the  first  hour,  until  a  maximum  sustained  flow  rate 
of  1,250  ft3/sec  was  reached.  Table  6-13  shows  the  addition  of  a  FUNCTION, 
TFRECORD,  and  several  TABFLOW  records  to  the  input  data  set  to  specify  the 
tabular  flow  forcing  function.  These  records  are  used  to  specify  inflow 
velocities  at  designated  times  during  the  simulation.  An  additional  RECGAGE 
record  was  placed  near  the  river  mouth  for  monitoring  purposes.  The  PRWINDOW 
record  was  used  to  print  elevations  at  hours  12  and  24  for  the  simulation 
(Table  6-14).  The  inlet,  ocean,  and  river  hydrographs  are  presented  in 
Figures  6-32  through  6-34  and  are  discussed  below. 

155.  From  Figure  6-32,  it  appears  that  the  elevations  at  all  three 
gages  are  dominated  by  the  tidal  forcing  functions.  The  velocities  at  the 
open  ocean  and  inlet  gages  are  dominated  by  the  tidal  forcing  (Figure  6-33); 
however,  the  river  gage  shows  only  a  small  oscillation  caused  by  the  tide 
(Figure  6-34).  There  is  little  evidence  of  the  river  inflow  since  the 
velocity  is  so  small. 


n  ti 


■  Go9»  LocoKo* 


Figure  6-31.  Computational  grid  for  the  river 
discharge  simulation 


6-72 


Table  6-13 


InBUt  Data. Set  for  the  River  Discharge  Simulation 


GENSPECS  CLHYD  SIMULATION  NO.  4:  TIDE  WITH  RIVER  DISCHARGE  ENGLISH 


TIMESPEC 

30. 

SECONDS 

1 

2880 

12 

GRIDSPEC 

ENGLISH 

75 

30 

37500. 

30000.  1. 

PRWINDOW 

1440 

E 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

RECGAGE 

10 

4 

RIVER  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BDRYX 

YBOUNDRYINTRPELV 

1 

17 

75 

2 

1  BDRY1 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1  BDRY2 

YBOUNDRYCONSTDIS 

1 

10 

10 

3 

RIVER 

FUNCTION 

1HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARMCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.6667 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

3TABFLOWS 

TFRECORD 

14 

3IRREGINT 

TABFLOW 

0. 

0.0 

0. 

0.0 

TAB FLOW 

0. 

6.0 

0. 

0.00625 

TABFLOW 

0. 

10.0 

0. 

0.0125 

TABFLOW 

0. 

16.0 

0. 

0.025 

TABFLOW 

0. 

20.0 

0. 

0.0375 

TABFLOW 

0. 

26.0 

0. 

0.0625 

TABFLOW 

0. 

42.0 

0. 

0.15 

TABFLOW 

0. 

50.0 

0. 

0.19375 

TABFLOW 

0. 

54.0 

0. 

0.2125 

TABFLOW 

0. 

58.0 

0. 

0.2275 

TABFLOW 

1. 

2.0 

0. 

0.24 

TABFLOW 

1. 

6.0 

0. 

0.24625 

TABFLOW 

1. 

8.0 

0. 

0.25 

TABFLOW 

24. 

0.0 

0. 

0.25 

XBARRIER 

18 

14 

14 

2.5 

XB1 

XBARRIER 

20 

15 

15 

2.5 

XB2 

XBARRIER 

22 

16 

16 

2.5 

XB3 

XBARRIER 

19 

17 

17 

2.5 

XB4 

XBARRIER 

21 

18 

18 

2.5 

XB5 

YBARRIER 

14 

17 

17 

2.5 

YB1 

YBARRIER 

15 

18 

19 

2.5 

YB2 

YBARRIER 

16 

20 

21 

2.5 

YB3 

YBARRIER 

17 

22 

23 

2.5 

YB4 

YBARRIER 

17 

17 

18 

2.5 

YB5 

YBARRIER 

18 

19 

20 

2.5 

YB6 

YBARRIER 

19 

21 

23 

2.5 

YB7 

BATHS PEC 

YX 

(8X.9F8.1) 

1 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0  -99.0 

-99.0  -99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0  -99.0 

-99.0  -99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0 

-99.0  -99.0 

-99.0  -99.0 
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Table  6-14 


Output  Summary  for  the  River  Discharge  Simulation 


COASTAL  H00ELIW6  SYSTEM  (CHS):  CLHYD 


VERSION  1.0 


CUWD  SIMULATION  NO.  4:  TIDE  WITH  RIVER  DISCHARGE 


*****  GENSPECS  CARD:  SPECIFICATION  OF  TITLE  AW  (DERAL  SYSTEM  OF  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALLE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE: 

-  -  -  -  « - - 

SUNITS  UNITS  SYSTEM  USED  IN  COWUTATIONS  ENGLISH  * 

SRIDSPEE  CARD:  SPECIFICATION  OF  DC  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 


value:  notes: 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  NOTES:  >  VARIABLE 

DESCRIPTION  OF  USAGE: 

value:  notes: 

6RTYPE 

TYPE  OF  FINITE-DIFFERENCE  GRID 

RECTANB 

«  SUNITS 

SYSTEM  OF  UNITS  USED  FOR  THE  GRID 

ENGLISH 

XCELL 

NUMBER  OF  GRID  (HIS.  X  DIRECTION 

75 

•  YCELL 

HUGER  OF  GRID  CELLS.  Y  DIRECTION 

30 

ALXREF 

TOTAL  LENGTH  IN  X  DIRECTION 

37500.00 

•  ALYREF 

TOTAL  LENGTH  IN  Y  DIRECTION 

30000.00 

*•••«  THESPEC  CARD:  SPECIFICATION  OF  CBfVTATIONAL  TIIE  UNITS 
VARIABLE  DESCRIPTION  OF  USAGE:  VALUE: 


NOTES:  •  VARIABLE  DESCRIPTION  OF  USAGE: 


VALUE'. 


NOTES: 


CELT  COtPUTATIONAL  TIME  STEP  (SEC0WS1  30.0 
IT1  THESTEP  AT  START  OF  MODEL  SHULATIQ  I 
WREO  THESTEP  INTERVAL  TO  SAVE  GAGE  DATA  12 


mm*  HYDROGRAPH  AND  VELOCITY  tEASURETENTS:  3  GAGES 


»  TUNITS 
♦  IT2 


THE  UNITS  FOR  ALL  INPUT  VWIABLES  SECONDS 
TOTAL  NOSER  OF  TIIESTEPS  SIMULATED  2800 


GAGE 

NUMBER: 

1 

2 


GAGE-POSITION 
X  Y  NOTES: 


VEL0CITY-IEA9URE1ENT 
TYPE:  NOTES: 


•  DTHOTS  THESTEP  INTERVAL  TO  SAVE  HOTSTARTS 


GAGE  NAK: 


19  l& 
42  15 


HtET  GAGE 
OCEAN  GAGE 


3 

10 

4 

RIVER  SAGE 

»•«*•  PRINTING 

OF  FIELD  ARRAY  VARIABLES:  1 

AREAS 

AREA  • 

STARTIN6 

ENDING 

STARTING 

EWING 

NUMBER  • 

X  CELL 

X  CELL 

Y  CELL 

Y  CELL 

1  • 

X-  I 

X=  75 

Y=  l 

Y=  30 

TI»ES  TO  PRINT  (SECONDS  ): 


VARIABLE  FIELD 


28S0 


1440  * 


*»*»  BATHSPEC  CARD:  SPECIFICATION  OF  BATHYtETRY/ TOPOGRAPHY 
VARIABLE  CCSCRIPTIOi  OF  USAGE; 


BUNITS 

WOATUN 

DLIHIT 


SYSTEM  OF  UNITS  FOR  DEPTH  DATA 
DATUM  FOR  HATER  DEPTHS 
MAXIMUM  DEPTH  ALLOWED 


VALLE:  NOTES:  »  VARIABLE  INSCRIPTION  OF  USAGE: 

FEET  •  5SE5 

o.ooo  *  ldatjm 

frViO.O  «  BFOPM 


value: 


notes: 


*sa5  se;ue.*ce  for-  depth  reai 

DATUM  -OR  LAND  ELEVATIONS 
cy-AT  y  depth  data 


YX 

0.000 

l?X,9F8.1) 


VUNEcR  of  ELEVATION  CHANGES  =  0 

••••  BARRIER  CARO:  SPECIFICATION  OF  LOCATION  AND  CHARACTERISTICS  "  3USGAID-;'”. -  EaraIc- 
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Figure  6-32.  Elevation  plots  for  the  river  discharge  simulation 


CURVE 
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Figure  6-33.  Velocity  plots  for  the  wind-induced  setup  simulation,  gages  1  and  2 


CURVE  SAG  HOR  VCR  SAGE  NAME 
_  3  10  i  RIVER  GAGE 


Figure  6-34.  Velocity  plot  for  the  wind- induced  setup  simulation,  gage 


Orthogonal  Curvilinear  Grid  Test  Series 

156.  A  second  series  of  tests  were  conducted  using  an  orthogonal 
curvilinear  grid  system.  As  Is  the  case  with  a  rectangular  grid  system,  this 
grid  represents  a  subset  of  a  generalized  curvilinear  grid  system.  The 
governing  equations  for  an  orthogonal  curvilinear  grid  have  more  nonzero 
transformation  terms  in  the  governing  equations  than  a  rectangular  grid,  but 
the  equations  are  not  the  "full"  equations  used  in  the  case  of  a  generalized 
curvilinear  grid  system. 

157.  The  basin  geometry  for  this  series  of  tests  is  a  section  of  a 
circular  annulus.  Analytic  solutions  that  describe  the  response  of  this  type 
of  basin  to  wind  and  tidal  forcing  are  available  (Lynch  and  Gray  1978).  The 
annular  section  and  corresponding  grid  used  in  the  test  series  are  presented 
in  Figure  6-35.  The  inner  radius  of  the  annulus  is  20,000  ft  and  the  outer 
radius  is  100,000  ft.  An  arc  of  42  degrees  is  subtended  between  the  lateral 
boundaries.  The  grid  contains  20  cells  in  the  radial  direction  and  14  cells 
in  the  angular  direction.  The  tests  presented  in  this  series  include:  static 
basin,  wind  induce  setup,  and  tidal  forcing  simulations  followed  by  a  series 
of  grid  resolution  tests. 


Static  Basin  Tests 

158.  The  static  basin  test  is  as  important  as  it  is  simple.  In  such  a 
test,  no  external  forces  are  applied  to  an  enclosed  basin  of  fluid.  The  basin 
is  expected  to  remain  at  rest;  that  is,  no  velocities  should  be  generated,  and 


6-78 


the  water  surface  should  remain  at  its  initial  level.  If  these  conditions  are 
met,  then  the  boundary  conditions  and  forces  in  the  momentum  equations  are 
formulated  properly. 

159.  The  basin  geometry  for  these  tests  was  described  above.  The  water 
depth  in  each  grid  cell  was  set  equal  to  30.0  ft.  The  initial  water  surface 
displacement  throughout  the  grid  was  set  to  0.0  ft  in  the  first  test  and  1.0 
ft  in  the  second  test.  The  length  of  the  simulation  was  20  hr,  or  1,200  time- 
steps,  with  each  time -step  representing  60  sec.  Figures  6-36  and  6-37  show 
the  water  surface  displacement  as  a  function  of  time  for  the  two  static  tests. 
Any  changes  in  the  water  surface  elevation  would  indicate  that  the  model  has  a 
problem  with  the  formulation  of  the  boundary  conditions  or  forces  in  the 
momentum  equations.  The  water  surface  elevation  results  si  ''W  that  the  model 
is  properly  formulated, 

160.  The  numerical  value  of  the  velocities  remained  zero  for  the 
simulation  with  an  initial  surface  displacement  of  zero.  However,  the 
numerical  value  of  the  velocities  in  the  second  test  were  on  the  order  of 
10‘16  fps.  All  tests  were  performed  on  a  VAX  11/750  computer,  which  operates 
with  a  32-bit  processor.  These  tests  were  run  using  double  precision; 
therefore,  the  value  of  the  velocities  are  of  the  same  order  of  magnitude  as 
the  maximum  number  of  significant  digits  for  a  64-bit  processor.  It  is, 
therefore,  concluded  that  the  small  velocities  produced  by  the  model  are 
caused  by  round-off  errors  inherent  to  the  computer  itself.  If  there  had 
truly  been  a  problem  with  mass  conservation,  then  the  velocities  would  most 
likely  have  been  much  greater  and  the  free  surface  would  have  changed  from  its 
initial  level.  The  success  of  these  tests  indicates  that  the  model  performs 
correctly  for  an  orthogonal  curvilinear  grid  system. 


Wind- Induced  Setup  Tests 


161.  When  a  steady,  uniform  wind  is  applied  to  an  enclosed  basin,  the 
water  surface  will  tilt  (or  setup)  in  the  direction  of  the  wind.  Such  a  test 
was  performed  on  the  annular  basin.  Three  simulations  were  made  using  the 
annular  basin  with  uniform  depth,  each  characterized  by  a  different  wind 
direction:  parallel  to  the  x-axis,  the  y-axis,  and  the  centerline  of  the 

basin.  A  wind  stress  of  0.07  lb/ft2  was  held  constant  for  all  three  tests. 
Regardless  of  the  configuration  of  the  basin,  at  steady  state  conditions  the 


6-79 


water  surface  should  be  linearly  varying  in  the  direction  of  the  wind  since 
the  depth  is  constant.  In  other  words,  the  water  surface  elevation  contours 
should  be  straight  lines  which  are  perpendicular  to  the  wind  direction. 

162.  Each  simulation  was  performed  for  1440  timesteps  of  60  sec  each 
for  a  total  simulation  time  of  24  hrs.  Figures  6-38  through  6-40  show  the 


Figure  6-36.  Static  basin  test  1 


contours  of  the  water  surface  elevation  at  steady- state .  In  all  three  cases 
the  contours  are  straight  and  perpendicular  to  the  wind  direction.  The 
magnitude  of  the  water  surface  slope  is  as  predicted  when  studying  the  balance 
of  momentum  in  the  direction  of  the  wind. 

Tidal-Forcing  Test 

163.  Lynch  and  Gray  (1978)  derived  analytic  solutions  that  describe  the 
hydrodynamics  created  by  a  tidal  forcing  along  the  outer  radial  boundary  of  an 
annular  section,  with  the  remaining  three  boundaries  closed.  As  in  the  case 
of  a  rectangular  basin,  a  standing  wave  pattern  is  created  in  the  annular¬ 
shaped  basin.  In  their  derivation,  Lynch  and  Gray  assumed  bottom  friction  was 
a  linear  function  of  the  water  depth.  In  order  to  compare  results  with  the 
"analytic"  solution,  the  model  CLHYD  was  modified  to  use  linear,  rather  than 
the  typically  used  nonlinear,  bottom  friction  formulation. 

164.  In  the  tidal  forcing  simulation,  the  water  depth  was  constant 
(30.0  ft)  throughout  the  basin.  Each  simulation  was  run  for  5,760  time-steps 
of  60  sec  each,  for  a  total  simulation  time  of  96  hr  (4  days).  Initial  flow 
field  parameters  were  set  equal  to  the  values  predicted  by  the  analytic 
solution  at  time  t  -  2,700  sec  (slightly  after  high  tide  when  the  velocities 
are  small).  The  linear  bottom  friction  coefficient  was  6.0  x  10'6  in  each 
simulation.  The  ratio  of  the  radial  grid  dimension  to  the  tidal  wavelength, 

A r/L  ,  was  approximately  1/170. 

165.  Figures  6-41  and  6-42  show  comparisons  between  simulated  water 
surface  displacements  (solid  lines)  and  the  analytic  solution  (dashed  lines) 
as  a  function  of  time  at  five  locations  within  the  grid.  Gages  1  and  5  show 
results  at  the  closed  and  open  ends  of  the  basin,  respectively.  The  model 
results  at  gage  5  are,  in  fact,  the  forcing  function  used  to  drive  the  model 
hydrodynamics,  i.e.,  the  analytic  solution.  From  Figures  6-41  and  6-42,  it  is 
shown  that  the  agreement  between  the  model  and  the  exact  solution  is  good. 
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Figure  6-41.  Comparisons  between  model  results  and  analytic  solution, 

gages  1  through  4 
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Figure  6-42.  Comparison  between  model  results  and  analytic  solution, 

gage  5 


Grid  Resolution  Tests  Using  Orthogonal  Curvilinear  Grids 

166.  To  simulate  wave  propagation  correctly,  CLHYD  must  be  able  to 
resolve  a  fluid  particle  moving  from  one  cell  to  the  next.  The  travel  time  of 
the  particle  defines  the  minimum  time  interval  between  successive  numerical 
solutions  of  the  governing  equations  (the  time-step).  Since  the  travel  time 
of  the  particle  is  dependent  on  the  cell  width  as  well  as  the  wave  celerity, 
the  time-step  is  also  a  function  of  these  parameters.  For  ADI  schemes,  such 
as  in  CLHYD,  the  ratio  of  the  distance  traveled  by  a  water  particle  in  one 
time -step  to  the  grid  cell  size  should  be  restricted  to  a  maximum  value  of 
approximately  5.  This  ratio,  referred  to  as  the  Courant  number,  is  presented 
below: 


C  = 

r  Ax 


(6-48) 


where 

At  =  time-step  size 
g  -  gravitational  acceleration 
H  -  water  depth 
Ax  -  grid  cell  width 
Cz  -  Courant  number 

167.  The  significance  of  the  time-  and  space-steps,  or  essentially  the 
Courant  condition,  was  investigated  in  the  following  series  of  tests.  A  set 
of  nine  tidal  forcing  simulations  were  conducted  in  the  annular  test  basin. 

In  each  test,  the  water  depth  was  constant  (30  ft)  throughout  the  basin,  the 
inner  radius  was  set  to  20,000  ft,  and  the  outer  radius  was  set  to  100,000  ft. 
To  investigate  model  accuracy,  simulations  with  various  grid  resolutions  and 
time -steps  were  conducted.  The  grids  ranged  from  a  20  x  14  grid  (Ar  -  4,000 
ft),  where  Ar  is  the  radial  grid  dimension,  to  a  8  x  7  grid  (Ar  =  10,000  ft), 
to  an  extremely  coarse  resolution  4x7  grid  (Ar  -  20,000  ft)  (Figures  6-43 
through  6-45).  The  Ar /L  ratio  thus  ranged  from  1/170  to  1/35.  Typically 
long- wave  simulations  involve  Ar /L  ratios  smaller  than  1/170,  but  the  objec¬ 
tive  of  this  test  series  was  to  test  the  extremes  to  which  the  model  can  be 
used. 

168.  The  actual  distance  between  the  tidal  boundary  and  the  far  end  of 
the  basin  differed  for  each  grid  because  the  tidal  boundary  condition  is 
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applied  at  the  center  of  each  of  the  outer  radial  cells.  Thus,  a  wave  would 
travel  a  different  distance  to  reach  the  far  end  of  the  basin  in  each  of  the 
three  grids.  Therefore,  the  selected  tidal  period  varied  for  the  three  basins 


Figure  6-43.  Annular  section  grid  no.  1  (20  x  14) 


Figure  6-44.  Annular  section  grid  no.  2  (8x7) 


Figure  6-45.  Annular  section  grid  no.  3  (4  x  7) 


in  order  to  create  a  standing  wave  pattern  in  each  basin.  For  each  test,  a 
tidal  forcing  amplitude  of  1.0  ft  and  period  of  approximately  5  to  6  hr  was 
selected. 

169.  Each  simulation  was  run  for  12  cycles  (72  hr)  with  the  time-step 
size  and  number  of  time -steps  varying  for  each  grid  and  Courant  number.  The 
model  time  step  was  selected  such  that  Courant  numbers  of  approximately  1,  4, 
and  8  could  be  maintained.  Table  6-15  provides  information  for  each  of  the 
numerical  simulations .  Initial  flow  field  parameters  were  set  equal  to  the 
values  predicted  by  the  analytic  solution  slightly  after  high  tide  when  the 
velocities  are  small.  The  linear  bottom  friction  coefficient  was  6.0  X  10‘6. 


Table  6-15 


Run 

Grid 

Ar._L£tl 

Ar/L 

At 

(sec) 

Number  of 
Ilffi.fS; 

Steps 

Courant 

Number 

CPU 

Time  (min) 

1 

20 

X 

14 

4000 

1/170 

120 

2160 

0.9 

12.87 

2 

20 

X 

14 

4000 

1/170 

540 

480 

4.2 

6.43 

3 

20 

X 

14 

4000 

1/170 

1080 

240 

8.4 

3.38 

4 

8 

X 

7 

10000 

1/70 

300 

864 

0.9 

2.55 

5 

8 

X 

7 

10000 

1/70 

1350 

192 

4.2 

0.70 

6 

8 

X 

7 

10000 

1/70 

2700 

96 

8.4 

0.43 

7 

4 

X 

7 

20000 

1/35 

600 

432 

0.9 

0.77 

8 

4 

X 

7 

20000 

1/35 

2700 

96 

4.2 

0.27 

9 

4 

X 

7 

20000 

1/35 

5400 

48 

8.4 

0.20 

170.  Figures  6-46  through  6-54  show  the  final  two  cycles  (12  hr)  of 
each  simulation.  Results  of  the  test  series  show  that  simulations  on  the 
finer  resolution  (20  x  14)  grid  show  good  agreement  with  the  exact  solution 
for  Courant  numbers  of  0.9,  4.2,  and  8.4  (Figures  6-46  through  6-48).  As  the 
grids  become  coarser  (8x7  and  4x7),  the  agreement  between  the  model  and 
exact  solution  diminishes  (Figures  6-49  through  6-54).  Similarly,  as  the 
Courant  number  increases,  the  agreement  between  the  model  and  the  exact 
solution  diminishes. 
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Figure  6-46.  Grid  resolution  test 


Figure  6-47.  Grid  resolution  test  2:  grid  1  (20 
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Figure  6-48.  Grid  resolution  test 


Figure  6-49.  Grid  resolution  test 
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Figure  6-50.  Grid  resolution  test  5:  grid  2  (8 


Figure  6-51.  Grid  resolution  test 


Figure  6-52.  Grid  resolution  test 


Figure  6-54.  Grid  resolution  test 


171.  The  root-mean- square  (SMS)  error  non 


[Exact- computed) 2 


(6-48) 


npts 


was  used  to  measure  the  difference  between  the  model  and  the  exact  solution 
for  the  entire  simulation  period  (Table  6-16).  The  error  increases  as  the 
grid  becomes  coarser  (Ar  increases)  and  as  the  Courant  number  increases  (Ar 
increases) . 

172.  The  cost  of  the  simulations,  however,  decrease  as  Ar  and  At 
increase.  Table  6-15  shows  the  CPU  time  on  a  VAX  11/750  for  each  of  the  nine 
simulations.  Grid  3  simulations  took  approximately  5  percent  of  the  time  of 
Grid  1  simulations. 

173.  The  bias  of  the  data: 


Bias  = 


nphs  ^Exact~conVPute<i') 


(6-49) 


npta 


shows  that  the  model  consistently  underpredicted  the  exact  solution 
(Table  6-17).  This  dampening  is  associated  with  a  weighting  factor  of  1.0 
used  in  these  simulations. 
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Table  6-16 


RMS . Erifti-  Nonas 


Grid  No.  1  (20x14) 

Courant  No. 

0.9 

Courant  No .  4.2 

Courant  No. 

8.4 

1 

0.00889 

0.02656 

0.05086 

2 

0.00824 

0.02469 

0.04729 

3 

0.00626 

0.01907 

0.03660 

4 

0.00344 

0.01065 

0.02047 

5 

0 . 00003 

0.00002 

0.00002 

Grid  No. .2  (8x7) 

Courant  No. 

0.9 

Courant  No.  4.2 

Courant  No. 

8.4 

1 

0.01431 

0.05689 

0.10481 

2 

0.01360 

0.05412 

0.09977 

3 

0.01062 

0.04239 

0.07830 

4 

0.00593 

0.02391 

0.04434 

5 

0.00002 

0.00001 

Grid  No.  3  (4x7) 

0.00001 

Courant  No. 

0.9 

Courant  No.  4.2 

Courant  No. 

8.4 

1 

0.02220 

0.08822 

0.13989 

2 

0.01775 

0.07087 

0.11280 

3 

0.01014 

0.04074 

0.06524 

4 

0.0002 

0.00001 

0.00001 
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Table  6-17 
Bias 


Grid  Po,  l  (2P«14) 


Courant  No. 

0.9 

Courant  No .  4.2 

Courant  No. 

8.4 

Gage 

1 

0.00364 

0.00377 

0.00392 

2 

0.00702 

0.00725 

0.00756 

3 

0.00959 

0.00995 

0.01033 

4 

0.01101 

0.01144 

0.01186 

5 

0.01101 

0.01144 

Grid  No.  2  (8x7) 

0.01186 

Courant  No. 

0.9 

Courant  No .  4.2 

Courant  No. 

8.4 

Gage 

1 

0.00337 

0.00361 

0.00386 

2 

0.00658 

0.00707 

0.00742 

3 

0.00907 

0.00973 

0.01025 

4 

0.01041 

0.01121 

0.01180 

5 

0.01041 

0.01121 

0.01180 

Grid  No.  3  (4x7) 


Courant  No .  0.9 

Courant  No .  4.2 

Courant  No .  8.4 

Gage  1 

0.00292 

0.00315 

0.00336 

2 

0.00521 

0.00571 

0.00608 

3 

0.00649 

0.00714 

0.00767 

4 

0.00649 

0.00714 

0.00767 
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174.  The  final  example  using  the  CLHYD  model  is  a  field  application  at 
Indian  River  Inlet,  Delaware  (Figure  6-55) .  The  purpose  of  this  example  is  to 
demonstrate  CLHYD' s  ability  in  a  more  realistic  (field)  environment.  Indian 
River  Inlet  was  selected  for  this  demonstration  because  field  data  and  results 
from  the  WES  Implicit  Flooding  Model  (WIFM)  exist  at  this  location. 

175.  Tide  and  velocity  gage  data  were  collected  at  Indian  River  Inlet 
during  the  period  29  June  1988  to  1  July  1988 .  Tide  gage  and  velocity  station 
locations  are  shown  in  Figures  6-55  and  6-56,  respectively.  WIFM  was  applied 
at  Indian  River  Inlet  and  vicinity  using  the  1988  prototype  gage  data  for 
calibration  purposes  (Lillycrop  et  al.,  in  preparation).  These  data  were  used 
for  comparison  to  CLHYD. 


Figure  6-55.  Indian  River  Inlet  and  vicinity 
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Figure  6-56.  Velocity  station  locations 

176.  A  portion  of  the  input  data  set  for  the  CLHYD  application  is  given 
in  Appendix  6-C.  The  grid  boundaries  are  shown  in  Figure  6-55.  In  this 
application,  an  84  x  84  cell  variable  rectilinear  grid  was  used  to  represent 
the  approximately  66,666  x  56,666  ft  study  area.  This  information  is  speci¬ 
fied  on  the  GRIDSPEC  record  as  variable  ICELLS-84,  variable  JCELLS-84, 
variable  ALXREF-66666 ,  and  variable  ALYREF-56666 .  The  units  of  the  grid  data 
(GUNITS)  were  specified  as  ENGLISH,  which  means  the  length  scale  used  for  the 
grid  was  feet.  The  grid  coordinates  were  provided  from  the  WIFM  simulation  as 
"grid  corner"  points;  therefore,  a  GRIDCORN  record  and  a  double  matrix  of  grid 
coordinates  followed  the  GRIDSPEC  record.  The  matrix  of  x-values  for  each 
corner  point  (XCT)  is  read  into  the  model  followed  by  the  matrix  of  y-values 
for  each  corner  point  (YCT) .  The  reader  should  refer  to  the  GRIDCORN  record 
in  Appendix  6-B  for  details. 
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177.  The  simulation  period  was  63  hr  (11,340  time-steps)  with  the  first 
37  hr  representing  the  model  warm-up  period.  The  time-step  (DELT)  was  20  sec. 
Gage  data  (free  surface  elevations  and  water  velocities)  were  recorded  every 
90  time-steps  (30  min)  as  specified  by  variable  NFREQ  on  the  T1MESPEC  record. 
This  information  was  used  to  produce  time -histories  of  C1HYD  model  results  at 
the  prototype  tide  and  velocity  gage  locations.  Non-linear  (advection)  terms 
were  also  included  in  the  governing  equations  for  this  simulation  (ADDTERMS 
record).  The  coriolis  coefficient  (COR)  was  set  to  0.00009  on  record 
ADDTERMS . 

178.  The  offshore  and  lateral  boundaries  were  forced  with  prototype 
tide  data,  and  the  interior  (bay)  boundary  was  assumed  to  be  a  closed  bound¬ 
ary.  The  prototype  tide  data  were  provided  as  tabular  elevation  values  at  30- 
min  intervals  (1,800  sec).  This  information  was  represented  in  the  model 
using  an  XBOUNDRY  record,  two  YB0UNDRY  records,  a  FUNCTION  record,  and  a 
TERECORD  record  followed  by  the  actual  elevation  values  that  forced  the 
offshore  and  lateral  boundaries  (see  Appendix  6-C). 

179.  Hourly  wind  data  (Figure  6-57)  were  obtained  from  the  U.S.  Coast 
Guard  Station  located  approximately  1  mile  north  of  the  inlet  (Figure  6-56). 
The  temporally  varying  prototype  wind  data  were  applied  at  each  grid  point, 
which  indicates  that  wind  was  assumed  to  be  spatially  constant  in  the  model 
(WNTRVLr-TVRUNISP) .  From  the  prototype  data,  a  series  of  TABWINDS  records  was 
constructed  to  represent  the  temporally  varying,  spatially  constant  wind  field 
for  the  time  period  of  the  simulation. 

180.  The  bathymetric  data  used  for  the  CLHYD  simulation  were  identical 
to  the  bathymetric  data  used  for  the  WIFM  application.  Bathymetric  data  are 
included  in  the  CLHYD  model  using  a  BATHSPEC  record  followed  by  a  matrix  of 
depth  values  for  each  grid  cell.  The  depth  values  relative  to  the  National 
Geodetic  Vertical  Datum  (NGVD)  were  obtained  for  this  application  from  the 
National  Oceanic  and  Atmospheric  Administration  (N0AA)  chart  12216.  The  units 
of  the  bathymetric  data  (BUNITS)  are  feet.  The  matrix  of  depth  values  was 
read  in  the  longshore  direction  (increasing  Y) ,  then  moving  offshore  (increas¬ 
ing  X).  This  corresponds  to  a  BSEQ  value  of  YX. 

181.  In  the  WIFM  application,  the  jetties  were  represented  by  designat¬ 
ing  "land"  cells  at  the  jetty  locations  rather  than  using  XBARRIER  and 
YBARRIER  records.  The  narrow  cell  width  (approximately  130  ft)  in  the 
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Figure  6-57.  Wind  data  used  in  Indian  River  application 


vicinity  of  the  inlet  justified  the  use  of  land  designation  rather  than 
infinitely  thin  barriers. 

182.  In  the  WIFM  application,  large  friction  values  were  selected  for 
the  cells  near  the  inlet  entrance  to  account  for  the  large  hydraulic  loss  that 
occurs  there.  For  comparison  purposes,  the  friction  values  used  to  obtain  the 
best  calibration  of  the  WIFM  model  were  used  in  the  CLHYD  model.  Friction 


values  were  thus  provided  for  each  individual  cell  by  selecting  "FRICTION 
TABULAR"  followed  by  a  matrix  of  Manning's  n  values  representing  the  friction 
in  each  grid  cell  (see  Appendix  6-C). 

183.  Time-history  (gage)  data  were  recorded  at  the  five  tide  gage 
locations  and  at  the  seven  velocity  station  locations  using  RECGAGE  records. 
The  free  surface  elevation  and  the  u-  and  v-velocity  components  were  recorded 
every  90  time -steps  (variable  NFREQ-90  on  the  TIMESPEC  record)  for  each  gage 
location.  Using  a  RECSNAPS  record,  snapshots  of  the  entire  flow  field  were 
recorded  every  4  hr  (720  time-steps),  beginning  at  hour  44  (time-step  7,920) 
and  ending  at  hour  52  (time-step  9,360). 

184.  A  comparison  of  CLHYD  model  results  to  WIFM  results  and  prototype 
data  are  given  for  the  five  tide  gage  locations  for  the  final  23  hr  of  the 
simulation  (Figures  6-58  through  6-62).  The  agreement  between  model  results 
and  prototype  data  is  excellent  for  all  five  gages. 
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Figure  6-58.  Comparison  of  water  surface 
elevations  at  Vines  gage 
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Figure  6-60.  Comparison  of  water  surface 
elevations  at  Massey  gage 
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Figure  6-61.  Comparison  of  water  surface 
elevations  at  Dewey  gage 


185.  Similarly,  a  comparison  of  CtliYD  model  results  to  WIFM  results  and 
prototype  data  for  the  seven  velocity  stations  is  given  in  Figures  6-63 
through  6-69  for  the  final  23  hr  of  the  simulation.  Some  of  the  WIFM  velocity 
results  were  given  as  averaged  velocities  between  adjacent  grid  cells  (Inlet 
Stations  1  and  3  and  Middle  Island  Station  1).  This  procedure  was  repeated 
with  CLHYD  results  to  obtain  a  consistent  comparison.  In  analyzing  the 
results,  it  is  found  that  the  agreement  at  the  Inlet  Stations  is  good  for 
stations  1  and  2,  but  the  model  underpredicts  the  magnitude  of  the  velocities 
appreciably  at  Inlet  Station  3  (Figure  6-65).  Several  factors  may  account  for 
the  discrepancies  in  the  velocities.  First,  gage  locations  are  approximate^ 
using  a  200-  to  500- ft  grid  cell,  and  therefore  the  exact  location  of  the 
actual  gage  is  only  approximated.  Secondly,  friction  was  adjusted  in  the  WIFM 
model  to  simulate  the  hydraulic  loss  through  the  inlet  and  obtain  the  best 
agreement  between  WIFM  model  results  and  measured  velocities.  The  friction 
values  used  in  CLHYD  could  have  been  altered  to  improve  the  agreement; 
however,  such  a  rigorous  calibration  is  not  the  primary  focus  for  this  simple 
example.  The  agreement  between  the  CLHYD  model  results  and  the  prototype  at 
the  Middle  Island  Stations  is  excellent  for  station  1,  good  for  stations  2  and 
4,  but  again,  the  model  underpredicts  the  magnitude  of  the  velocity  at  station 
3. 
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Figure  6-63.  Comparison  of  water  surface 
elevations  at  Inlet  gage 


6-64.  Comparison  of  velocities  at  Inlet  Station  1 


Figure  6-66.  Comparison  of  velocities  in  Inlet  Station  3 


Figure  6-68.  Comparison  of  velocities  at 
Middle  Island  Station  2 
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Figure  6-69.  Comparison  of  velocities  at 
Middle  Island  Station  3 


186.  Discharge  ranges  were  selected  across  the  inlet  and  the  entrance 
to  Rehobeth  Bay.  This  was  specified  In  the  model  by  including  two  RECRANG 
records  in  the  input  data  set  to  record  flow  rates  for  the  entire  simulation 
period  at  these  two  locations  (Figures  6-70  and  6-71).  This  information  can 
then  be  used  to  compute  the  tidal  prism.  The  flow  rate  through  the  inlet  is 
approximately  12,000  cfs,  whereas  the  unit  flow  rate  into  Rehobeth  Bay  is  only 
7,000  cfs. 

187.  Snapshots  of  the  entire  flow  field  were  recorded  at  hours  44,  48, 
and  52.  The  peak  ebb  (hour  44)  and  peak  flood  (hour  52)  snapshots  are  shown 
in  Figures  6-72  and  6-73,  respectively.  Velocities  are  greatest  through  the 
inlet  throat  as  expected.  Velocity  vectors  for  every  eighth  cell  were  plotted 
in  the  figures. 

188.  This  field  application  is  intended  to  illustrate  to  the  user  the 
various  capabilities  of  the  CLHYD  model.  The  complexity  of  "real-world" 
problems  makes  the  application  of  models  such  as  CLHYD  a  suitable  means  of 
reaching  an  engineering  decision  to  a  specific  coastal  problem. 
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Figure  6-70.  Discharge  through  Indian  River  Inlet 


Figure  6-71.  Discharge  into  Rehobeth  Bay 
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VELOCITY  VECTORS  SIMULATION  TIMC:  S2 . 00 HOURS 


Figure  6-73.  Snapshot  at  hour  52 
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APPENDIX  6-A:  TRANSFORMATION  OF  ADVECTION  AND  DISPERSION  TERMS 
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The  advective  (inertia)  tens  in  the  x-  and  y-aoaentua  equations  are 
given  as: 
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These  expressions  are  represented  in  the  transformed  plane  as: 
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Finite  Difference  Representation 

The  upwind  treatment  of  the  advective  terms,  otherwise  known  as  the 
"pigpen  method"  (Roache  1972),  is  implemented  in  the  CLMYD  model.  In  this 
formulation,  the  effect  of  a  perturbation  is  carried  only  in  the  direction  of 
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the  velocity.  D.  B.  Spalding  called  this  the  pigpen  method  because  a 
concentrated  quantity  would  be  "smelled"  only  downwind  of  the  source.  This 
translates  into  the  model  as  leaning  that  a  point  in  the  grid  is  affected  only 
by  what  occurs  upwind  of  it.  The  advantages  of  this  method  is  its  simplicity 
in  formulation  and  stability  of  the  solution  due  to  its  dispersive  nature. 

The  stability  can  also  act  as  a  disadvantage  if  the  dispersion  becomes 
excessive . 


X- Momentum 

For  flow  in  the  positive  x-direction,  the  finite  differences  are  taken 
between  cells  i-2  and  i  in  accordance  with  the  pigpen  method: 
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For  flow  in 
cells  i+1 
are  similar 


the  negative  x-direction,  the  finite  differences  are  taken  between 
and  i  in  accordance  with  the  pigpen  method,  and  the  equations 
to  those  shown  above . 
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For  flow  in  the  positive  y-direction,  the  finite  differences  ar  taken 
between  cells  j-1  and  j  in  accordance  with  the  pigpen  method: 
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The  dispersion  terms  in  the  x-  and  y-momentum  equations  are  given  as: 


X- Momentum 
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X-tteaeatua 


These  expressions  are  represented  in  the  transformed  plane  as: 
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invent  metric  tumor 
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The  treatment  of  the  advective  and  dispersive  terms  is  different  near 
boundaries.  The  velocity  cross  derivative  is  assumed  to  be  zero  near  the 
boundary,  and  a  slip  condition  exists.  This  "slip"  boundary  is  assumed  for 
both  the  advection  and  dispersion  terms. 


APPENDIX  6-B:  CLHYD  DATA  SPECIFICATION  RECORDS 
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(Req)  GENS PECS 
(Req)  TIMESPEC 
(Opt)  ADDTERMS 
(Opt)  STARTUP 


(Req)  GRIDSPEC 
(C-Opt)  GRIDCORN 
(C-Opt)  XSTRETCH 
(C-Opt)  YSTRETCH 


(Req)  BATHSPEC 
(Req) 

(Opt)  CHNGBATH 
(Opt)  XBARRIER 
(Opt)  YBARRIER 
(Opt)  FRICTION 
(Opt)  FRICTABL 
(Opt)  CHNGFRIC 


(Opt)  XBOUNDARY 

(Opt)  YBOUNDARY 

(C-Opt)  FUNCTION 
(C-Opt)  CNRECORD 
(C-Opt)  CONSTIT 
(C-Opt)  TERECORD 
(C-Opt)  TFRECORD 
(C-Opt)  TABELEV 


Model  Control  Specifications 

Specify  general  title  and  system  of  units 
Specify  time -related  controlling  variables 
Specify  optional  terms  in  governing  equations 
Specify  initial  conditions 

Grid  Description 

Specify  general  grid  characteristics 
Specify  x-  and  y  corner  points  for  grid 
Specify  x-coordinates  to  create  stretched  grid 
Specify  y-coordinates  to  create  stretched  grid 

Physical  Characteristics 

Specify  characteristics  of  bathymetry/topography 
Two  dimensional  array  of  bathymetric/topographic 
data 

Specify  changes  to  the  bathymetric/topographic  data 

Specify  barrier  perpendicular  to  x-axis 

Specify  barrier  perpendicular  to  y-axis 

Specify  character  of  bottom  friction 

Specify  entry  for  depth-variable  friction  table 

Modify  the  friction  values  at  selected  locations 

Boundary  Conditions 

Specify  driving  boundary  perpendicular  to  x-axis 
Specify  driving  boundary  perpendicular  to  y-axis 
Specify  driving  boundary  forcing  function 
Specify  attributes  of  constituent  forcing 
Specify  harmonic  constituent  forcing  function 
Specify  attributes  of  tabular  elevation  forcing 
Specify  attributes  of  tabular  velocity  forcing 
Specify  irregularly  spaced  tabular  elevations 
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(C-Opt)  TABFLOW 


(Opt)  WINDS PEC 
(C-Opt)  TABWINDS 


(Req)  PRWINDOW 

(Opt)  RECGAGE 

(Opt)  RECSNAPS 

(Opt)  RECRANG 


Specify  irregularly  spaced  tabular  velocities 

Wind- Field  Specifications 

Specify  the  character  of  wind- field  data 
Specify  wind-field  tabular  data 

Output  Specifications 

Specify  location  and  timing  of  a  print  window 
Specify  location  of  recording  gage  in  grid 
Specify  snapshot  time(s)  for  recording 
Specify  discharge  range  perpendicular  to  x-axis 
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CMS  Data  Specification:  GENSPECS  Record:  (Req) 

Purpose:  Specify  general  title  and  system  of  units. 


>4 

« 

4J 

o  <0 
«  & 
w 

O  \  44 

«  a  o 
urn 
«  \  3 

a  <a  a  o  a 


w 

a 

4) 

• 

0) 

V4 

V4 

V4 

<u 

o 

W 

"0 

—-4 

*+-l 

C 

(4-1 

in 

4) 

4> 

4J 

1—4 

4) 

U 

c 

4J 

X. 

C 

4) 

s-l 

4J 

o 

•o 

*J 

—4 

*t4 

(fl 

1-4 

4) 

<0 

t3 

<4 

U 

4-1 

V4 

V4 

41 

d 

o 

0) 

r-4 

o» 

o 

e 

o 

B 

a> 

4) 

4) 

o 

04 

O 

Q 

o 

X 

04 

M 

O  \  <4-1 

H 

4)  4-1  O 

hJ  'i 

04  4-1  ^ 

o  t-4 

O  \ 

Z  ot] 

4J 

«  4J  3  4) 

W  M 

<4-1 

04  44  O  44 

0) 

# 

U  Vi  K 

.c  -h  <a  a 

4-1  O  W 

bll  II  0  U  It 

C  B  h  it  « 

II  -I  II  U 

rt  H  >  O  fc 


o*  -u  u 

£88 


OO 

<£> 

V4 

* 

* 

4) 

V4 

U 

40 

4) 

(0 

6 

00 

4J 

6 

c 

M 

a  ot 

|  g  | 

Shot 


O' 

I  o 

CM  r-4 


6-126 


CMS  Data  Specification:  TIMESPEC  Record:  (Req) 

Purpose:  Specify  time-related  controlling  variables. 


CMS  Data  Specification:  STARTUP  Record:  (Opt) 

Purpose:  Specify  inital  conditions. 
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CMS  Data  Specification:  XSTRETCH  and  YSTRETCH  Records:  (C-opt) 

Purpose:  Specify  the  data  to  create  grid  coordinates  in  a  stretched  rectilinear 

cartesian  coordinate  system. 
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CMS  Data  Specification:  GRIDCORN  Record;  (C-opt) 


CMS  Data  Specification:  BATHSPEC  Record:  (Req) 
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9-10  BNAME  Char  *16  (Opt)  A*  Name  of  bathymetry/topography  set. 


(1)  The  actual  2-D  array  of  bathymetry/topography  data  follows  this 

(2)  Conventions  for  2-D  array  read  sequence  mnemonics: 


* 

* 


CMS  Data  Specification:  CHNGBATH  Record:  (Opt) 

Purpose:  Specify  changes  to  the  bathymetry  data. 


CMS  Data  Specification:  FRICTION  Record:  (Opt) 

Purpose:  Specify  character  of  bottom  friction. 
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(Continued) 


FSEQ  Char  *8  (Opt)  XY  XY  The  2-D  array  of  friction  values 

-XY  that  follows  this  record  is  read 
X-Y  a  sequence  specified  by  this  mne 
-X-Y  code  (see  notes  for  the  convent! 
YX  represented  by  these  mnemonics) . 


CMS  Data  Specification:  FRICTABL  Record:  (C-opt) 

Purpose:  Specify  an  entry  in  the  friction  value  versus  bathymetry  table. 


CMS  Data  Specification:  CHNGFRIC  Record:  (Opt) 

Purpose:  Modify  the  friction  values  at  selected  locations. 


CMS  Data  Specification:  XBARRIER  and  YBARRIER  Records:  (Opt) 

Purpose:  Specify  the  location  and  characteristics  of  a  subgrid- scale  barrier. 


6-141 


CMS  Data  Specification:  XBOUNDRY  and  YBOUNDRY  Record:  (OPT) 

Purpose:  Specify  location  and  character  of  a  driving  boundary. 
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BNDFN1  Integer  (C-opt)  +1*  Integer  index  of  forcing  function 

(tabular  or  harmonic  constituent)  for 
CONSTELV,  INTRPELV  or  CONSTDIS  type 


CMS  Data  Specification:  IUNCTION  Record:  (C-opt) 

Purpose:  Specify  index  number  and  character  of  driving  boundary  forcing  function. 
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datum"  quantity. 


CMS  Data  Specification:  CNRECORD  Record:  (C-opt) 

Purpose:  Specify  physical  coordinates  and  timing  of  a  constituent  forcing  function. 
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< 


CMS  Data  Specification:  TERECORD  and  TFRECORD  Record:  (C-opt) 

Purpose:  Specify  general  information  for  a  tabular  elevation  (TERECORD) 

or  tabular  (TFRECORD)  boundary  forcing  function. 


•d 

Vi 

•* 

•3 

M 

a 

• 

M  «  Q 

4> 

O 

iH  3 

4  <  J 

U 

• 

o 

3  43 

'O  ■o 

r4  »H  C 

y 

s 

4) 

43  V» 

«  Vl 

3  V  CO 

3 

> 

V4 

<0  , 

45  *3  0 

So  y  5 

Vl  r-l 

o 

V)  <w 

u  mm  y 

«  C  H 

O  C  *3  3 

H 

V4 

o 

•H  O  >  3 

Vl  « 

4-1  O  *r-l  Vi  CO 

«4H 

cd 

4) 

43  44  o  Vl 

V4  u  • 

y  o 

rH 

-C  v> 

3  Vl 

•rM  rH  O 

•3  "3  O  H 

Vi 

U 

3 

V)  Vl 

Uhl) 

3  -o 

41  «  41  Cl  z 

cd 

<d 

3 

44  4)  t4 

y  3  >  vi 

W  4)  "3  Vi  M 

pH 

rH 

cd 

G  V 

4)  —1  04  43 

4  ■O  W  O 

3  TH  *rH  o 

3 

3 

u 

M-t  0) 

rH  q  44 

4  4  0 

r-l  >  01  U 

*2 

/-n  p. 

3  >  Id  4 

H  p,  e  n  s 

cd 

cd 

0) 

CO  (3.  O  60 

3  -r4  oq  Vl 

hi  p.  vi  q  2 

v> 

u 

J* 

vi  q 

H  <4  4J  c 

•3  T3  < 

t-4  <d  p.  y  i— i 

4-1 

V)  44 

VM  -  *rl 

rH  SH  4 

<44  ' 

Vi 

u 

C 

£>  1-1  -r-l 

-r-l  4  60  <4-4 

O 

0 

c 

4)  W 

5  •O  44  O 

O  C  43 

y  <d  y  C  -rl 

*V? 

<4H 

tH 

<0 

c  _ 

H  #  4H 
*3  -O  r-l 

vi  <4-1  o  y 
p.  o 

a>  y  «  <rH 
p.  cd  "3  S»  ^ 

Q) 

B 

Vi 

U 

CO 

id  •G 

c  vi  o 

•3  60 

CO  *3  O  r-4  - 

0) 

0) 

0) 

.  v 

•H  O  *0  *44 

3  <0  3  C 

*3  r-4  p. 

C 

•H 

•H 

<4-1  U 

U  4) 

V  4)  rl  *rl 

44  V  41  H  p,  cl 

<4-1 

<V4 

Vl 

O  3 

«  y  c-> 

3  B  <vi  S 

3  3  y  o  3  > 

•«H 

■U 

r-l  Vl  4  4 

-4  4Q 

S  r-l  d  <44  O 

u 

•U 

V) 

C 

Vl  4) 

3  p.  VI 

3  44  y  r-l 

C  3  a  y  q 

o 

c 

• 

G 

a) 

3  43 

>  3  m  u 

y  ' —  41  H 

o  q  co  o  3 

o 

0) 

w 

-O 

u  Vi  i  id 

a  p.  o 

4-1  3  3  C 

<D 

3 

■o 

<4H 

i  ° 

3  3  >•, 

•3  «  C0  <4-1 

y  >m  H 

V4 

O 

T-l 

O 

3  44 

y  r-l  a 

r— 4 

r-M  r-4  y  Bl  fe 

c 

•  3  <0  H  i 

M  4  «  4 

3  60  Vl  3  3  H 

u 

■G 

VI 

TJ 

Vl 

•3 

■3  -4  4)  3  r-l 

3  >  43  "3 

G  C  3  o  cd 

cd 

Vi 

cd 

Vl 

0) 

X  VI 

Vl  mH  i— 1 

rH  V4  y 

O  —i  r-l  Q  -3  2 

pH 

O 

> 

O 

£ 

4)  O 

o  «  Vi  p  « 

3  4)  r-l  o 

•t-4  ■S  3  i 

3 

O 

0) 

o 

g 

■a  o 

y  B  44  60 

43  y  r-l  y 

y  3  60  r-M  •  M 

rO 

pH 

a> 

3 

C  4) 

4)  -4  G  4)  C 

at  C  *rH  4) 

p.  41  3  •  o 

cd 

cd 

a> 

Z 

W  Jm 

Vl  f-4  4)  Vl  v4 

H  n  >  V 

O  V4  Vl  3  -4-1 

H 

•3 

at  q 

y  3  2 
*j  «  o 
no 

4)  U 

Cm  H 


Vl  U 

V  4) 

60  60 

4)  4) 

4J  4J 

a  c 


6-148 


3 


CMS  Data  Specification:  WINDSPEC  Record:  (Opt) 

Purpose:  Specify  the  character  of  wind-field  data. 
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by  several  TALWINDS  records.  Each 
TABWINDS  record  is  followed  by  wind 
speed  arrays. 


CMS  Data  Specification:  PRWINDOW  Record:  (Opt) 

Purpose:  Specify  location  and  timing  of  a  print  window. 
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Note:  Use  1  PRWINDOW  record/window  (in  space  or  time_ 


CMS  Data  Specification:  RECGAGE  Record:  (Opt) 

Purpose:  Specify  location  and  character  of  a  recording  gage  in  the  grid. 
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CMS  Data  Specification:  RECSNAPS  Reocrd:  (Opt) 

Purpose:  Specify  snapshot  time(s)  for  recording. 
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CMS  Data  Specification:  XRECRANG  and  YRECRANG  Records:  (Opt) 

Purpose:  Specify  location  and  name  of  a  discharge  recording  range  within  the  grid. 
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APPENDIX  6-C:  INPUT  DATA  SET  FOR  THE  INDIAN  RIVER  INLET  EXAMPLE 
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GENSPECS  INDIAN  RIVER  INLET  ENGLISH 


GRIDSPECCURVILIN 

ENGLISH 

84 

84  66666.6 

66666.6  1.0 

GRIDCORN  XY 

3333.33301 

(F12 . 5 ,4F16 
5000.00000 

.5) 

6666.66699 

8333.33301 

10000.0000 

11666.6699 

13333.3301 

15000.0000 

16666.6699 

18333.3301 

20000.0000 

21666.6699 

23333.3301 

25000.0000 

26666.6699 

28333.3301 

30000.0000 

31666.6699 

33333.3281 

35000.0000 

36666.6602 

38106.6719 

39183.3281 

40000.0000 

40666.6602 

41250.0000 

41770.0000 

42226.6719 

42636.6719 

43003.3281 

43333.3281 

43633.3281 

43906.6602 

44160.0000 

44396.6719 

44613.3281 

44813.3281 

45000.0000 

45186.6602 

45390.0000 

45610.0000 

45846.6602 

46100.0000 

46373.3281 

46666.6602 

TIMESPEC 

20.  SECONDS 

1  11340 

90 

ADDTERMS 

YES 

NO 

0.0 

0.00009 

YBOUNDRYCONSTELV 

1 

70  83 

1 

XBOUNDRYCONSTELV 

84 

1  84 

1 

YBOUNDRYCONSTELV 

84 

68  83 

1 

FUNCTION 

1TABELEVS 

FEET 

0.5 

TERECORD 

127 

1 

1800.  (15F5.2) 

1.80  1.90 

2.00  2.11 

2.42 

2.42  2.39  2.23 

1.90  1.54  1.12  0.72  0.13  -.56-1.15 

-1.61-2.07- 

-2.30-2.42- 

-2.39- 

-2.29-1.97-1.74- 

-1.41-0.98-0.49-0.10  0.30  0.59  0.69 

0.76  0.66 

0.06  0.36 

0.13 

-.26  -.62-1.18- 

-1.61-2.07-2.36-2.49-2.52-2.26-2.00 

-1.61-1.18 

-.69  -.10 

0.56 

1.12  1.77  2.20 

2.62  2.78  2.88  2.79  2.49  2.20  1.77 

1.28  0.66 

0.16  -.46- 

-1.12- 

-1.67-2.07-2.26- 

-2.29-2.19-1.90-1.64-1.32  -.89  -.26 

0.16  0.59 

0.98  1.12 

1.25 

1.25  1.18  0.95 

0.66  0.46  0.00  -.43-1.05-1.54-1.94 

-2.19-2.26- 

■2.32-2.10- 

-1.74- 

•1.35  -.85  -.39 

0.23  0.85  1.51  2.03  2.55  2.88  3.05 

2.92  2.82 

2.62  2.30 

1.84 

1.35  0.62  -.16 

-.89-1.44-1.94-2.16-2.19-2.23-2.00 

-1.77-1.38 

-.98  -.69 

-.10 

0.26  0.76  0.00 

0.00 

WINDS PECTVRUNISP 

FPS 

TABWINDS 

0 

0 

-2.201  11.077 

TABWINDS 

0 

1 

-2.096  12.884 

TABWINDS 

0 

2 

-0.763  13.472 

TABWINDS 

0 

3 

2.750  13.210 

TABWINDS 

0 

4 

5.101  8.570 

TABWINDS 

0 

5 

3.952  7.200 

TABWINDS 

0 

6 

5.934  5.022 

TABWINDS 

0 

7 

5.988  3.088 

TABWINDS 

0 

8 

7.783  2.120 

TABWINDS 

0 

9 

6.150  0.348 

TABWINDS 

0 

10 

4.494  -0.692 

TABWINDS 

0 

11 

6.008  -1.361 

TABWINDS 

0 

12 

4.059  -0.625 

TABWINDS 

0 

13 

3.290  -0.745 

TABWINDS 

0 

14 

3.857  -2.117 
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TABWINDS 

0 

15 

5.194 

-2.396 

TABWINDS 

0 

16 

2.875 

2.031 

TABWINDS 

0 

17 

-3.090 

0.930 

TABWINDS 

0 

18 

-6.266 

2.501 

TABWINDS 

0 

19 

-5.526 

5.876 

TABWINDS 

0 

20 

-6.123 

7.497 

TABWINDS 

0 

21 

-10.286 

3.899 

TABWINDS 

0 

22 

-8.928 

6.916 

TABWINDS 

0 

23 

-5.832 

4.200 

TABWINDS 

1 

0 

-3.526 

4.317 

TABWINDS 

1 

1 

10.423 

1.696 

TABWINDS 

1 

2 

11.877 

0.257 

TABWINDS 

1 

3 

10.183 

3.755 

TABWINDS 

1 

4 

6.334 

2.720 

TABWINDS 

1 

5 

4.485 

1.860 

TABWINDS 

1 

6 

4.708 

1.643 

TABWINDS 

1 

7 

7.489 

3.372 

TABWINDS 

1 

8 

6.713 

-0.677 

TABWINDS 

1 

9 

4.413 

1.987 

TABWINDS 

1 

10 

0.535 

3.924 

TABWINDS 

1 

11 

7.816 

3.357 

TABWINDS 

1 

12 

5.941 

4.044 

TABWINDS 

1 

13 

6.841 

3.371 

TABWINDS 

1 

14 

7.104 

2.341 

TABWINDS 

1 

15 

8.083 

1.460 

TABWINDS 

1 

16 

7.517 

-3.309 

TABWINDS 

1 

17 

3.155 

-6.129 

TABWINDS 

1 

18 

-6.163 

-1.913 

TABWINDS 

1 

19 

-7.929 

-3.082 

TABWINDS 

1 

20 

-9.665 

-2.999 

TABWINDS 

1 

21 

-7.295 

1.652 

TABWINDS 

1 

22 

-7.072 

3.881 

TABWINDS 

1 

23 

-6.039 

1.819 

TABWINDS 

2 

0 

-6.660 

4.286 

TABWINDS 

2 

1 

-3.646 

8.490 

TABWINDS 

2 

2 

-2.020 

7.961 

TABWINDS 

2 

3 

3.413 

4.406 

TABWINDS 

2 

4 

8.600 

1.866 

TABWINDS 

2 

5 

10.069 

-1.016 

TABWINDS 

2 

6 

4.721 

-5.990 

TABWINDS 

2 

7 

5.169 

-4.780 

TABWINDS 

2 

8 

-0.551 

-11.427 

TABWINDS 

2 

9 

-3.668 

-11.454 

TABWINDS 

2 

10 

-8.492 

-13.718 

TABWINDS 

2 

11 

-5.476 

-9.200 

TABWINDS 

2 

12 

-2.071 

-7.340 

TABWINDS 

2 

13 

-3.808 

-8.250 

TABWINDS 

2 

14 

-8.427 

-9.776 

TABWINDS 

2 

15 

-7.454 

-9.624 

BATHS PEC 

FEET 

0.0 

0.0 

YX(10F8 . 1) 

0.0 

0.0 

0.0 

9.5 

9.4 

9.6  10.1 

7.4 

10.0 

8.5 

8.5 

8.5 

8.5 

8.5 

8.5 

8.4  8.4 

7.9 

7.8 

7.5 

7.5 

7.4 

7.4 

7.4 

7.4 

7.9  7.8 

7.8 

7.8 

7.8 

7.8 

7.7 

7.7 

7.7 

7.7 

7.7  7.6 

7.6 

7.6 

7.6 

7.2 

7.2 

7.2 

6.7 

6.7 

7.2  7.2 

7.1 

7.1 

7.1 
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7.1 

7.1 

7.0 

7.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

39.0 

38.0 

37.0 

38.0 

41.5 

41.3 

40.0 

39.0 

39.4 

39.0 

40.3 

42.0 

40.0 

39.9 

35.0 

39.0 

39.0 

39.0 

38.9 

38.2 

38.1 

38.0 

38.0 

37.9 

37.0 

37.0 

37.0 

37.0 

37.1 

37.1 

37.1 

37.2 

37.2 

37.2 

39.2 

38.2 

38.4 

38.4 

38.5 

38.5 

38.6 

38.6 

38.7 

32.5 

31.9 

31.6 

31.5 

34.0 

31.5 

30.2 

30.6 

38.0 

31.9 

32.5 

32.6 

37.2 

37.0 

37.6 

37.6 

37.9 

38.3 

38.4 

38.8 

38.0 

37.8 

40.0 

39.9 

40.3 

43.7 

47.0 

43.9 

45.0 

44.1 

45.0 

49.0 

48.0 

48.5 

47.7 

47.9 

50.0 

50.0 

47.4 

48.0 

46.0 

38.0 

41.0 

40.0 

41.0 

41.2 

40.0 

38.9 

38.0 

38.0 

39.0 

40.4 

38.0 

41.1 

42.4 

45.0 

41.8 

41.8 

41.7 

42.2 

42.1 

42.1 

42.0 

42.3 

38.0 

41.1 

41.1 

41.1 

41.1 

41.1 

41.1 

41.1 

41.1 

40.0 

40.0 

39.9 

39.9 

40.0 

40.6 

40.6 

40.6 

40.5 

35.5 

35.1 

34.6 

39.0 

33.1 

32.9 

39.1 

33.0 

33.2 

33.4 

33.7 

38.5 

38.5 

38.3 

38.3 

38.2 

38.3 

38.3 

38.0 

38.5 

38.6 

38.9 

40.8 

40.9 

41.7 

43.8 

48.0 

46.6 

47.0 

50.0 

48.7 

48.7 

49.4 

49.7 

51.5 

51.0 

49.0 

50.7 

51.0 

51.0 

51.0 

50.0 

44.0 

FRICTION  TABULAR  YX(10F7.3) 
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CHAPTER  7 

SHALWV  THEORY  AND  PROGRAM  DOCUMENTATION 


PART  I :  INTRODUCTION 

1.  The  Spectral  Wave  Modeling  module  of  the  Coastal  Modeling  System 
(CMS)  was  developed  co  make  the  spectral  wave  models,  SHALWV  (Resio  1984)  and 
STWAVE  (Resio  1990) ,  readily  available  to  field  offices  within  the  Corps  of 
Engineers.  In  the  past,  engineers  needing  the  modeling  power  of  SHALWV  had  to 
contact  the  model's  developers  at  the  Coastal  Engineering  Research  Center 
(CERC)  to  run  the  program  for  a  particular  application.  Now,  SHALWV,  as  well 
as  STWAVE,  may  be  run  by  logging  into  the  CMS  and  conducting  a  "user  friend¬ 
ly,"  interactive  modeling  session  with  the  programs. 

2.  The  Spectral  Wave  Modeling  module  makes  operation  of  the  programs 
easy  and  efficient.  Pre-  and  postprocessing  routines  are  included  in  the 
module,  such  that  the  input  files  for  the  programs  can  be  built,  the  programs 
can  be  run,  and  the  results  can  be  immediately  displayed  and  evaluated  through 
menu  selections  and  question-answer  sessions.  The  goal  of  the  operational 
simplification  of  the  models  is  to  minimize  the  time  required  to  set  up  and 
run  the  models  and  maximize  the  time  for  evaluating  the  results. 

3.  Operating  the  Spectral  Wave  Modeling  module  is  largely  self  explana¬ 
tory  through  the  existence  of  on-line  help  options.  However,  this  user's 
guide  is  aimed  at  providing  theoretical  background,  explaining  all  of  the 
user's  options,  ns  well  as  the  Spectral  Wave  Modeling  module's  full  capabili¬ 
ties.  The  following  information  is  covered  in  this  document: 

a.  Part  II  briefly  discusses  the  theory,  assumptions,  limitations, 
and  methodology  used  in  SHALWV  and  STWAVE. 

b.  Part  III  outlines  the  structure  of  the  Spectral  Wave  Modeling 
module . 

c.  Part  IV  describes  the  Spectral  Wave  Modeling  module  functions 
and  routines. 

d.  Part  V  provides  a  brief  description  of  the  contents  of  each  file 
used  and/or  created  by  the  Spectral  Wave  Modeling  module.  It 

a? so  provides  a  description  of  the  data  format  required  for  each 
file. 
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PART  II:  DESCRIPTION  OF  THE  SPECTRAL  WAVE  MODELING  PROGRAMS 


Theoretical  Foundation 

4.  SHALWV  Is  the  Corp's  most  versatile  spectral  wave  model.  It  has  the 
capability  of  modeling  the  following  applications: 

&.  Enclosed  bodies  of  water. 

&.  Open  coasts. 

£.  Arbitrary  bathymetry. 

Time-varying  wind  or  wave  conditions. 

£.  Shallow-  or  deepwater  wave  growth. 

£.  Swell  wave  transformations. 

g.  Fetch-  or  duration- limited  wave  growth. 

h.  Unlimited  fetch  and/or  unlimited  duration  wave  growth. 

i.  Long  simulations  (e.g.  hindcasts). 

j. .  Rapidly  turning  winds  (e.g.  hurricane  events). 

5.  SHALWV  numerically  simulates  growth  and  decay,  as  well  as  propaga¬ 
tion,  shoaling,  refraction,  diffraction,  and  sheltering  of  a  directional  wave 
spectrum  over  an  arbitrary  bathymetry.  The  spectrum  is  represented  two 
dimensionally  in  discrete  frequency  and  direction  bands.  The  spectra  are 
modeled  in  a  time -dependent  mode,  so  that  most  time -varying  wave  and  wind 
conditions  can  be  simulated.  The  model  operates  on  a  square-celled  computa¬ 
tional  grid  and  uses  the  following  Courant  number  stability  criterion  to 
determine  adequate  computational  time -steps: 

M  >  Cg(f')  (7-1) 


where 

AL  -  length  of  a  grid  cell 
At  -  computational  time -step 

Ct  -  group  velocity  associated  with  the  lowest  spectral  frequency 
at  the  deepest  grid  point 

f*  -  lowest  spectral  frequency  value 

The  Courant  number  stability  criterion  assures  that  wave  energy  cannot 
propagate  more  than  one  grid  cell  during  a  time-step.  The  water  depth  is 
included  in  Equation  7-1  through  Ct  defined  by: 
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c  =  —  c  [l  ♦  2kh  I 
*  2  [  sinh  (2kh)  J 


(7-2) 


where 

C  -  wave  celerity 

k  -  wave  number  -  ^ 

L  -  wavelength 
h  -  water  depth 

6.  The  program  employs  an  explicit  upstream  finite  difference  scheme  to 
solve  the  following  spectral  balance  equation: 


||  +  V  •  (dgS)  -  S,t  +  §nJ  +  §4.  +  s*  + 


(7-3) 


where 

E  -  spectral  energy  density  at  (f,  0) 
t  -  time 

f  -  frequency  of  spectral  component 
9  -  propagation  direction  of  spectral  component 

Si  -  ith  source  quantity  described  below 

The  left-hand  side  of  Equation  7-3  is  an  expansion  of  the  total  derivative  of 
the  directional  energy  density  containing  a  term  representing  the  temporal 
change  in  the  spectral  energy  density  and  terms  representing  the  advection  of 
the  spectral  wave  energy.  The  right-hand  side  of  Equation  7-2  contains  the 
source  terms  representing  physical  mechanisms  that  add  to,  or  subtract  from, 
net  energy  in  the  wave  field.  These  source  terms  include  atmospheric  energy 
input  (Sat),  nonlinear  wave-wave  interactions  (Snl) ,  bottom  dissipation  (S,*) , 

-4 

wave  dissipation  within  the  wave  field  (Sdi),  and  surf-zone  breaking  (Sbr)  . 

Advection  Terms 

7.  Advection  of  the  wave  energy  in  each  discrete  frequency-direction 
band  is  performed  independently.  A  stepwise  solution  estimates  the  wave  ray 
along  which  the  energy  contained  in  each  discrete  band  propagates  in  order  to 
arrive  at  the  grid  point  of  interest  by  the  end  of  the  time-step  (Figure  7-1). 
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Figure  7-1.  Illustration  of  propagation  method 

Point  A  in  Figure  7-1  represents  the  location  of  the  wave  energy  contained  in 
the  discrete  frequency-direction  band  at  the  beginning  of  the  time-step.  An 
estimate  of  this  energy  is  obtained  by  an  interpolation  method  that  first 
projects  the  wave  ray  farther  back  in  time  until  a  grid  boundary  is  crossed 
such  as  point  B  in  Figure  7-1.  This  estimated  energy  is  propagated  along  the 
wave  ray  as  refraction  and  shoaling  effects  are  estimated,  reaching  the  grid 
point  C  at  the  end  of  the  time-step.  After  propagating  all  energy  into 
point  C,  energy  is  added  to,  or  removed  from,  each  discrete  energy  band  by  the 
source  terms.  At  the  end  of  the  time -step,  the  directional  spectrum  at  each 
grid  point  is  the  sum  of  the  independently  propagated  spectral  elements. 

Since  the  grid  spacing  can  be  large,  smooth  bathymetry  is  assumed. 

Source  Terms 

8.  The  SHALWV  model  assumes  that  the  primary  source  mechanisms  for 
storm  waves  in  arbitrary  water  depths  are  the  atmospheric  energy  input  (as 
originally  proposed  by  Phillips  (1957)),  the  nonlinear  wave-wave  interactions, 
and  internal  wave  field  dissipation.  The  atmospheric  source  term  is  formulat¬ 
ed  such  that  the  energy  addition  due  to  wind  stress  is  confined  primarily  at 
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the  peak  of  the  spectrum  and  to  the  higher  frequencies  of  the  spectrum 
regions  II  and  III  In  Figure  7-2)  In  deep  water.  During  fully  developed 
conditions  where  there  is  no  additional  wave  growth,  wind  energy  cannot  be 
transferred  directly  to  the  sea  surface. 
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Figure  7-2.  Source/sink  mechanism  for  spectral  energy 

transfers 


9 .  As  the  water  depth  decreases ,  the  lower  frequency  waves  become 
nondispersive  and  begin  to  travel  at  a  celerity  that  depends  on  the  depth. 
SHALWV  assumes  that  as  waves  approach  the  nondispersive  limit  in  shallow 
water,  the  lower  frequencies  of  the  spectrum  become  incapable  of  receiving 
direct  atmospheric  input,  as  well  as  become  incapable  of  receiving  energy  from 
the  midrange  frequencies  through  wave-wave  interactions. 

10.  The  dashed  line  in  Figure  7-2  represents  the  relocation  of  wave 
energy  between  frequencies  via  the  nonlinear  wave -wave  interactions  (Hassel- 
mann  1962)  during  active  wave  growth.  Energy  is  shifted  in  both  directions 
from  region  II.  Energy  shifted  to  higher  frequencies  (region  III)  is  dissi¬ 
pated  through  viscous  and  turbulent  processes.  Although  wave -wave  interaction 
is  a  conservative  process,  the  model  "loses"  this  energy  by  limiting  the 
energy  in  the  higher  frequencies  of  the  spectrum  to  the  depth- limited  spectral 
form.  Energy  shifted  to  the  lower  frequencies  contributes  to  wave  growth  and 
the  shifting  of  the  spectral  peak  to  lower  frequencies,  which  in  turn  allows 
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the  midrange  to  accept  more  energy  through  atmospheric  input.  The  wave -wave 
interaction  term  is  sensitive  to  both  the  energy  contained  in  the  spectrum  and 
the  shape  of  the  spectrum. 

11.  The  model  contains  a  procedure  for  the  transformation  of  swell  wave 
energy  that  is  required  when  a  bimodal  spectrum  is  input  at  the  start  of  a 
simulation,  when  winds  are  turned-off  at  some  point  during  the  simulation,  or 
when  the  spectral  peak  moves  out  of  the  growth  region.  The  model  calculates 
the  wind  sea  spectrum  at  each  grid  point  and  subtracts  that  spectrum  from  the 
total  energy  spectrum.  Any  remaining  energy  at  frequencies  with  phase  speeds 
greater  than  or  equal  to  the  wind  speed  is  treated  as  swell.  Then,  the  peak 
frequency  of  the  swell  and  the  total  swell  energy  are 

calculated. 

12.  Bottom  friction  and  percolation  are  not  considered  in  the  calcula¬ 
tion  of  the  wind  sea  spectrum.  However,  source  terms  are  present  for  bottom 
friction  and  percolation  that  allow  the  user  to  include  these  effects  for 
swell.  The  effect  of  bottom  friction  and  percolation  is  to  decrease  the 
spectral  energy  levels  due  to  bottom  influences.  The  effect  of  bottom 
friction  on  and  percolation  is  accounted  for  in  the  wind  sea  balance  through 
the  empirical  TMA  (Hughes  1984)  relationships  for  wave  growth. 

Diffraction  and  Sheltering 

13.  In  nature,  energy  propagating  toward  a  point  directly  behind  an 
obstruction,  such  as  an  island,  may  be  blocked  by  the  obstruction.  However, 
some  of  the  energy  may  still  reach  the  sheltered  point  due  to  diffraction 
around  the  obstruction.  Diffraction  around  obstructions  is  included  in  SHALWV 
by  implementation  of  a  scheme  presented  by  Penny  and  Price  (1952)  and  Wiegel 
(1962).  This  method  applies  Sommerfeld's  solution  for  diffraction  of  light 
waves  at  the  edge  of  a  semi- inf inite  screen  to  water-wave  diffraction  at  the 
edge  of  a  semi -infinite  breakwater.  The  assumptions  are  that  linear  wave 
theory  applies,  water  depths  are  uniform,  and  the  breakwater  is  semi- inf inite 
and  provides  complete  reflection. 

14.  Obstructions  such  as  islands  are  represented  in  SHALWV  as  grid 
points  defined  as  land.  (See  question  GF-22  in  Part  IV  and  the  Land/Water 
File  description  in  Part  V.)  Thus,  wave  energy  is  allowed  only  to  propagate 
around  these  points,  not  through  them.  The  diffraction  option  in  SHALWV  can 
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be  used  to  improve  the  calculation  of  energy  that  propagates  into  the  region 
behind  an  obstruction. 

15.  Due  to  the  computational  scheme  used  in  SHALWV,  certain  cautions 
must  be  applied  when  specifying  the  size,  shape,  and  diffracting  effect  of  an 
obstruction.  Figure  7-3  shows  three  different  specifications  for  an  obstruc¬ 
tion.  Figure  7-3a  is  an  obstruction  specified  by  a  single  land  point.  The 
lengths  of  the  wave  propagation  vectors  indicate  the  relative  amount  of  energy 
diffracting  into  the  region  behind  the  obstruction.  Figure  7 -3b  shows  an 
obstruction  specified  by  two  adjacent  land  points.  In  this  case,  the  land 
points  will  not  block  energy  propagating  between  the  points.  They  block  only 
the  energy  that  tries  to  pass  directly  through  the  points.  Two  or  more 
adjacent  points  are  required  as  shown  in  Figure  7 -3c  to  provide  complete 
blocking  of  energy  between  points . 

16.  Since  many  obstructions  are  very  irregular  in  shape  or  are  small 
compared  with  the  user's  computational  grid  spacing,  using  three  or  more 
points  to  block  wave  energy  at  a  location  is  not  always  logical.  Hence, 

SHALWV  has  an  additional  option  for  sheltering  (or  blocking)  wave  energy  at 
given  locations.  Sheltering  by  obstructions  is  achieved  through  an  array  of 
sheltering  coefficients  that  represent  the  percentage  of  energy  in  each 
spectral  direction  band  (see  question  GF-6  and  GF-7  in  Part  IV)  allowed  to 
reach  a  grid  point.  For  points  around  islands  that  experience  sheltering,  the 
coefficients  can  be  defined  for  every  angle  band. 

Initial  and  Boundary  Conditions 

17.  SHALWV  contains  a  feature  that  allows  the  user  to  initialize  each 
grid  point  with  a  specified  TMA  directional  wave  energy  spectrum  at  the  start 
of  a  simulation.  These  spectra  are  called  initial  conditions.  Additionally, 
SHALWV  contains  a  feature  that  allows  the  incoming  wave  energy  at  the  bound¬ 
aries  of  the  computational  grid  to  be  updated  during  the  simulation  to 
represent  the  actual  prototype  conditions  and  to  prevent  unrealistic  loss  of 
wave  energy  through  the  side  boundaries,  such  as  in  an  open  coast  application. 
These  are  called  boundary  conditions.  The  program  BCGEN  is  included  in  the 
Spectral  Wave  Modeling  module  to  generate  the  initial  and  boundary  conditions 
for  SHALWV. 
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lend  Point  ot  Grid  Node 


(A)  Single -point  obstruction 


(6)  Two-point  obstruction 


(C)  Multi-point  obstruction 


Figure  7-3.  Representation  of  obstructions  on  the 
SHALWV  computational  grid 


18.  SHALWV  contains  a  cost-  and  time-saving  feature  that  allows  users 
to  preprocess  time- independent  elements  of  the  SHALWV  simulation  when  several 
similar  simulations  are  planned.  The  preprocessing  option  computes  the  time- 
independent  characteristics  of  the  simulation,  such  as  the  phase  and  group 
velocities  of  each  spectral  energy  band.  If  the  discretization  of  the  energy 
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spectrum  and  the  bathymetry  data  remain  unchanged  between  simulations,  then 
the  time -independent  characteristics  can  be  preprocessed  once  for  all  simula¬ 
tions  and  stored  in  a  file.  Then,  during  the  simulations,  only  the  time- 
dependent  characteristics  are  computed,  while  the  time- independent  data  are 
read  from  a  file. 


Warm  Starts 

19.  When  long  simulations  must  be  run,  such  as  long-duration  hindcasts, 
multiple  SHALWV  simulations  might  be  required.  For  example,  to  simulate  a  1- 
year  hindcast,  twelve  1 -month  simulations  might  be  performed.  To  maintain 
consistency  between  one  simulation  and  the  next,  wind  and  wave  information  for 
the  last  time-step  of  the  first  simulation  is  used  to  initialize  wind  and  wave 
conditions  for  the  second  simulation,  etc.  Because  the  wind  and  wave  informa¬ 
tion  is  initialized  in  the  second  and  subsequent  simulations,  they  are  said  to 
have  "warm  starts."  Figure  7-4a  shows  example  results  of  a  segmented  simula¬ 
tion  when  warm  starts  are  not  used,  while  Figure  7-4b  shows  example  results 
when  warm  starts  are  used.  SHALWV  and  the  Spectral  Wave  Modeling  module  are 
configured  to  facilitate  multiple  simulations  using  "warm  starts."  (See 
question  GF-26  in  Part  IV) 
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Computational  Grids  and  Subgrids 

20.  The  computational  grid  required  by  SHALWV  must  contain  square  grid 
cells.  The  columns  of  the  grid  should  be  oriented  north- south  and  the  rows 
oriented  east-west.  The  SHALWV  has  no  provision  to  include  curvature  effects 
of  the  Earth,  so  the  grid  must  have  an  expanse  generally  less  than  20'  in 
latitude  and  longitude.  Figure  7-5  shows  the  computational  grid  orientation 
convention. 

21.  When  input  boundary  conditions  are  not  available,  SHALWV  may 
require  that  a  large  water  body  be  modeled  even  though  the  user  is  only 
interested  in  a  small  portion  of  the  water  body.  Modeling  the  large  water 
body  is  necessary  to  determine  the  wave  conditions  that  propagate  into  the 
region  of  interest  from  other  regions.  However,  modeling  the  large  water  body 
reduces  the  resolution  of  SHALWV' s  results  in  the  region  of  interest.  To 
improve  the  model  resolution,  subgrids  may  be  used  which  refine  the  original 
grid  as  shown  in  Figure  7-6.  The  method  of  applying  subgrids  is  as  follows. 
First,  the  large  water  body  is  modeled  with  a  large  computational  grid  (grid 
cells  are  large).  While  the  large  water  body  is  modeled,  wave  information  is 
saved  at  locations  around  the  region  that  will  be  modeled  with  a  subgrid  (see 
example  locations  in  Figure  7-6).  The  saved  information  is  then  used  as  input 
boundary  conditions  for  the  subgrid  simulation.  The  subgrid  simulation  period 
is  the  same  as  the  original  simulation  period  except  that  the  computations  are 
concentrated  only  in  the  region  of  the  subgrid.  The  input  boundary  conditions 
generated  during  the  original  simulation  are  used  to  drive  the  subgrid 
simulation. 


Assumptions  and  Limitations  of  SHALWV 

22.  Although  the  SHALWV  program  is  the  Corps  of  Engineers'  most  versa¬ 
tile  arbitrary  water  depth  wave  model,  it  was  created  with  certain  assumptions 
and  limitations,  like  all  programs.  The  SHALWV’ s  inherent  assumptions  and 
limitations  are  listed  below: 

Assumptions 

a.  The  source  term  for  high-frequency  wave  dissipation  can  be  rep¬ 
resented  by  limiting  the  shape  of  the  wave  spectrum. 
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Figure  7-5.  Orientation  convention  for  the  computational  grid 
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Figure  7-6.  Relationship  between  an  "original"  computa¬ 
tional  grid  and  a  subgrid 


b.  The  bathymetry  between  grid  nodes  is  linear. 


c . 


Refraction  can  be  computed  based  on  the  change  in  depth  between 
the  deepwater  input  boundary  and  point  of  interest. 


d.  Bottom  friction  and  percolation  are  significant  only  when 
considering  swell  waves. 


e.  The  lower  frequencies  of  the  wave  energy  spectrum  do  not 
receive  energy  input  from  the  atmosphere  when  these  waves  are 
in  the  nondispersive ,  shallow-water  region. 

f .  A  TMA  (Hughes  1984)  spectral  shape  limits  the  sea  wave 
spectrum. 


g.  Wave  growth  is  adequately  represented  by  the  Joint  North  Sea 
Wave  Program  (JONSWAP)  wave  growth  criteria  (Hasselmann  et  al. 
1976). 


Limitations 

a.  Wave-current  interactions  are  not  represented. 


&.  The  variation  of  the  still-water  level  with  time  is  not  repre¬ 
sented  (e.g.  storm  surge). 


L2 


£•  Variable  grids  or  boundary -fit ted  grids  cannot  be  used. 

d.  Numerical  stability  depends  on  the  Courant  number  criterion. 

£.  The  Earth's  curvature  is  neglected.  Therefore,  only  a  portion 
of  the  ocean's  surface  may  be  modeled  during  a  given 
simulation. 
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PART  III:  STRUCTURE  OF  THE  SPECTRAL  WAVE  MODELING  MODULE 

Intrvdwtlvn 

23.  The  Spectral  Wave  Modeling  Module  of  CMS  contains  two  operational 
branches.  The  branch  containing  the  SHALWV  program  is  used  when  time-varying 
spectral  wave  problems  are  addressed,  and  the  branch  containing  the  STWAVE 
program  is  used  when  time -invariant  spectral  wave  problems  are  addressed. 

Time -varying  problems  include  cases  where  the  growth  of  wave  conditions  is 
important,  i.e.,  wind,  sea,  and  swell  vary  over  time.  Time- invariant  problems 
include  cases  where  the  transformation  of  design  wave  conditions  near  a 
project  site  are  of  interest. 

24.  The  Spectral  Wave  Modeling  Module  of  CMS  makes  execution  of  SHALWV 
and  STWAVE  simple  by  removing  the  burden  of  organizing  data  and  files.  When  a 
user  begins  a  modeling  session  with  the  Spectral  Wave  Modeling  Module,  the 
operational  branch  (STWAVE  or  SHALWV)  must  be  selected.  The  module  then  leads 
the  user  through  an  interactive  session  of  file  building,  wave  simulations, 
and/or  output  data  processing.  The  module  prompts  the  user  for  all  of  the 
information  pertinent  to  the  particular  function  and  routine  being  used.  For 
the  simplest  applications,  the  only  item  a  user  needs  during  use  of  the  module 
is  a  bathymetric  map  of  the  region  of  interest.  Descriptions  of  the  informa¬ 
tion  required  by  each  function  and  routine  is  provided  in  Part  IV. 

25.  The  SHALWV  and  STWAVE  branches  of  the  module  are  similar.  Both 
branches  have  basic  functions  to  build  input  files,  run  module  programs,  and 
postprocess  results.  Also,  the  selection  menus  used  in  each  branch  are 
similar.  Although  the  two  branches  of  the  module  are  similar,  the  specific 
aspects  of  each  program  are  discussed  separately  to  make  this  user's  guide 
more  convenient  while  working  with  one  program  or  the  other.  The  general 
structure  of  the  Spectral  Wave  Modeling  module  is  illustrated  in  Figure  7-7. 

Operational  Structure  of  the  SHALWV  Branch 

26.  The  operational  functions  of  the  SHALWV  branch  of  the  Spectral  Wave 
Modeling  module  are  illustrated  in  Figure  7-8.  The  file-building  function 
must  be  used  prior  to  the  function  to  run  programs,  and  the  function  to  run 
programs  must  be  used  prior  to  the  function  to  postprocess  the  model  results. 
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Figure  7-7.  General  structure  of  the  Spectral  Wave  Modeling  jfodule  of  CMS 

Figures  7-9  through  7-11  indicate  the  files  created  and  used  by  each  routine 
within  each  function  of  the  SHALWV  branch.  The  coordination  between  the 
functions  and  the  routines  within  each  function  can  be  followed  by  observing 
which  routines  create  what  files,  as  well  as  which  routines  use  those  files. 
Each  file  has  an  associated  identifying  letter  and  number.  Files  that  are 
required  for  input  are  identified  with  the  letter  "R" . 

27.  Files  that  are  automatically  created  are  identified  with  the  letter 
"A,"  and  files  that  are  optionally  created  or  required  are  identified  with  the 
letter  "0."  The  contents  and  format  of  data  within  each  file  are  described  in 
Part  V. 
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FILE  BUILDING  FUNCTION  PROGRAMS  FUNCTION 


GENERAL  FILE  BUILDING 


WIND  FILE  BUILDING 


BOUNDARY  CONDITION 
BUILDING 


INTERP 


BCGEN 


SHALWV 


POSTPROCESS  FUNCTION 


GRAPHICAL  DISPLAY 


STATISTICAL  DISPLAY 
(PRINT  FILES) 


Figure  7-8.  Organization  of  functions  and  routines  within  the  SHALWV  branch 

of  the  Spectral  Wave  Modeling  module 
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Figure  7-10.  Run-Programs  Function  and  Routines 


FILE  * 


OPTION 


W 

X 


3 

O 

X 

u 

z 

M 

to 

to 

x 

o 

o 

x 

x 


to 

3 

x 

to 


z 

x 

x 

x 

o 

to 


to 

x 

3 


o 

z 


to 

o 

M 

£ 

3 

o 


to 

x 

X 

o 

3 

3 

a 

X 

x 

M 

< 

X 

X 

M 

< 

Eh 

X 

(Lt 

U 

fH 

X 

X 

X 

£ 

to 

to 

£ 

to 

X 

• 

• 

to 

• 

• 

• 

X 

• 

u 

u 

X 

+ 

+ 

W 

+ 

X 

+ 

+ 

M 

II 

3 

x 

H 

lJ 

X 

E- 

M 

X 

- - - 

Q 

3 

a 

X 

Q 

M 

a 

3 

a 

X 

Q 

b 

. — ^ 

x 

-  o 

D 

x 

X 

M 

x 

M 

X 

> 

fc- 

X 

W 

X 

M 

X 

> 

3 

> 

X 

3 

M 

X 

w 

X 

M 

u 

X 

U 

> 

X 

w 

Ou 

W 

X 

M 

X 

> 

x 

> 

fn 

x 

M 

2  * 

M 

M 

X 

U( 

x 

X 

to 

lJ 

> 

Eh 

X 

X 

X 

X 

X 

X 

X 

3 

31 

3 

to 

X 

to  > 

(l4 

X 

M 

< 

M 

H 

w 

H 

• 

M 

X 

3 

w 

M 

M 

< 

w 

H 

•H 

M 

to 

M 

to 

CL. 

• 

•  X 

M 

u 

X 

o 

U 

u 

b< 

Eh 

X 

to 

X 

• 

bf 

o 

X 

o 

U 

u 

X 

• 

b 

• 

z 

z 

I* 

Eh  tO 

u 

Q 

X 

H 

X 

< 

u 

to 

• 

z 

z 

X 

H 

X 

< 

X 

M 

M 

M 

W 

X 

to  • 

u 

♦J 

X 

O 

X 

X 

X 

u 

X 

u 

M 

M 

M 

X 

X 

CJ 

X 

X 

X 

U 

£ 

X 

£ 

H 

Z  M 

X 

X 

to 

U 

to 

< 

to 

£ 

£ 

£ 

£ 

■J 

to 

1 

X 

X 

1 

< 

X 

£ 

Z 

£ 

Z 

3 

5 

x 

O  X 

to 

M 

1 

X 

1 

X 

1 

z 

Z 

g; 

M 

X 

£ 

1 

< 

x 

< 

U] 

< 

L-l 

£ 

u  < 

1 

X 

X 

to 

X 

u 

X 

z 

M 

z 

u 

<C 

Ch 

X 

CO 

X 

U 

X 

Z 

3 

Z 

3 

£S 

< 

X 

X  > 

X 

u 

x 

u 

lJ 

l3 

X 

< 

X 

X 

X 

w 

M 

x 

M 

X 

X 

X 

X  X 

x 

U 

to 

u 

to 

u 

to 

w 

M 

u 

M 

X 

X 

X 

to 

X 

X 

X 

X 

3 

ah 

3 

z 

to 

H 

a  x 

to 

> 

3 

> 

3 

> 

3 

3 

bu 

lJ 

tu 

z 

w 

> 

3 

> 

3 

> 

3 

M 

M 

x 

< 

'-a 

3 

< 

< 

< 

w 

M 

>wr 

X 

wr 

< 

w 

< 

< 

fan 

u. 

u 

ffi 

X 

X 

X 

X 

X 

o 

X 

X 

X 

FILE  * 

cr> 

fH 

CM 

in 

\D 

<T> 

in 

vO 

<N 

fH 

fH 

fH 

fH 

fNJ 

fH 

<H 

«H 

fH 

OPTION  « 

X 

X 

x 

a 

X 

X 

X 

X 

X 

X 

X 

X 

X 

< 

z 


< 

z 


< 

z 


x 

3 


x 

3 


to 
o 

M 

H  — 
to  a 

M  X 
X  M 
X  X 
X  H 

o 
x 

CL. 

to 

I 

05 
X 

x  to 
>  3 
<  — 
x 


u 
3 
X  M 


< 

x 

< 

s 

o 


to 

o  — 
h  a 
X  x 
to  M 

M  X 
El  M 
<  O 
H  U 

to  a. 
3  ? 

x  to 

Z  3 
U 

u 


H  — 
3  O 
CL.  X 
H  M 
3  X 
O  M 
O 
a  x 

3  CL. 

u  to 

M  I 

x  a: 
x 

W  to 
>  3 
<  — 
2 


to 

o 

M 

to 

M 

Eh 

< 

Eh 

M 


CO 

a> 

c 


3 

O 

P'5 

PC 

c 

•rt 

CO 

CO 

at 

u 

o 

L 

CL 

I 

LI 

CO 

O 

X 


<u 

u 

3 


a 

A* 

3 

■o 


HO  O  tt 


7-19 


Optionnlly  Crentcd  or  Required  filr 
Required  Input  file 


PART  IV:  MODULE  FUNCTIONS  AND  ROUTINES 

SHALWV  Module  Functions  and  Routines 


28.  The  first  function  of  the  SHALWV  branch  of  the  Spectral  Wave 
Modeling  module  of  CMS  is  to  build  most  or  all  of  the  necessary  input  files 
for  the  user's  application.  The  second  function  is  to  run  SHALWV  and  related 
programs.  The  third  function  is  to  display  graphically  or  statistically  the 
results  of  the  user's  most  recent  SHALWV  run.  Descriptions  of  the  operation 
of  each  function  and  routine  and  the  specific  information  required  by  each 
function  and  routine  are  presented  in  the  following  sections. 

29.  The  organizational  procedures  for  different  types  of  simulations 
are  presented  below: 

Simulation  #1:  Preprocessing  time- independent  information  only;  no  wave 

simulations;  no  warm  starts;  no  subgrids;  no  input  boundary 
conditions;  no  output  boundary  conditions. 

Procedure :  Run  General  File  Building  Routine. 

Run  SHALWV. 


After  the  time- independent  data  are  preprocessed  by  SHALWV, 
the  General  File  Building  Routine  is  rerun  specifying  "Cal¬ 
culating  Waves  Only"  instead  of  preprocessing.  No  wind  or 
boundary  condition  data  can  be  processed  when  "Preprocessing 
Only"  is  specified.  The  wind  and  boundary  condition  data 
are  time -dependent  and  therefore  will  be  specified  during 
the  "Calculating  Waves  Only”  simulation,  below. 

Calculating  Waves  Only;  no  warm  starts;  no  subgrids;  no 
input  boundary  conditions;  no  output  boundary  conditions. 

Procedure :  Run  General  File  Building  Routine. 

Run  Wind  File  Building  Routine. 

Run  SHALWV. 


Notes : 


Simulation  #2: 


Postprocess  Results. 

Note :  A  "Calculating  Waves  Only"  simulation  is  the  same  as  "Pre¬ 

processing  and  Calculating  Waves  Only"  simulation  below 
except  that  the  time- independent  data  that  would  be  calcu¬ 
lated  during  the  SHALWV  simulation  are  read  from  a  file. 
Therefore,  if  the  "Preprocessing  Only"  option  (Simulation 
#1)  was  used  prior  to  "Calculating  Waves  Only”  simulation, 
Simulations  #3  through  #7  may  also  be  run  using  "Calculating 
Waves  Only" . 
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Simulation  #3: 

Procedure : 
Simulation  #4: 
Procedure : 
Note: 


Simulation  #5: 
Procedure : 


Note : 


Simulation  #6: 


Procedure : 


Simulation  #7: 


Procedure : 


Preprocessing  and  Calculating  Waves;  no  warm  starts;  no 
subgrids;  no  input  boundary  conditions;  no  output  boundary 
conditions. 

Same  as  Simulation  #2. 

Same  as  Simulation  #3  except  using  warm  starts. 

Same  as  Simulation  #3. 

Warm  starts  can  be  used  only  if  a  previous  simulation  used  a 
warm  or  cold  start  with  the  save  option.  Also  when  using 
warm  starts,  the  last  wind-field  and  boundary  condition 
input  during  the  previous  simulation  must  be  repeated  as  the 
first  input  of  the  current  simulation. 

Same  as  #3  except  using  subgrids. 

Run  General  File  Building  Routine. 

Run  INTERP. 

Run  SHALWV. 

Postprocess  Results. 

Subgrids  can  be  used  only  if  a  previous  simulation  saved 
output  boundary  conditions  at  the  boundary  grid  points  of 
the  subgrid.  Input  boundary  conditions  must  come  from  the 
previous  simulation.  Wind  information  is  also  obtained  from 
the  previous  simulation. 

Same  as  #3  except  with  user-specified  input  boundary  condi¬ 
tions  . 

Run  General  File  Building  Routine. 

Run  Wind  File  Building  Routine. 

Run  Boundary  Condition  File  Building  Routine. 

Run  BCGEN. 

Run  SHALWV. 

Postprocess  Results. 

Same  as  Simulation  #3  except  using  output  boundary  condi¬ 
tions  (for  a  subsequent  Subgrid  Simulation). 

Same  as  Simulation  #3. 


File  building  functions 

30.  The  first  function  of  the  SHALWV  module  is  to  assist  users  in 


building  the  input  files  required  by  SHALWV.  Users  are  prompted  for  input 
through  a  series  of  menu  selections  and  question- answer  sessions.  It  is 
recommended  that  the  file-building  function  routines  be  used  whenever  possible 
to  minimize  potential  file  format  and  organizational  errors.  However,  some 
files  may  be  easier  to  build  externally  on  the  user's  preferred  word  proces- 
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sor.  Such  files  will  be  identified.  The  proper  format  for  the  files  and 
definitions  of  the  data  that  must  be  included  in  the  files  is  found  in  Part  V. 

31.  Three  routines  can  be  used  to  build  the  necessary  input  files  for 
SHALWV.  The  first  is  the  General  File-Building  routine  (Part  IV),  which 
builds  up  to  six  of  the  input  files  required  by  SHALWV.  The  files  are  called: 

General  Input  File. 

1).  Bathymetry  File. 

c.  Sheltering  File. 

d.  Subgrid- Interpolation  File. 

£.  Parameter  File. 

f.  Main  File  Name  File. 

All  of  the  files  are  required  for  every  SHALWV  simulation  except  for  the 
Subgrid- Interpolation  File,  which  is  required  only  for  special  subgrid  appli¬ 
cations  (described  in  Part  II).  The  second  file-building  function  routine  is 
the  Wind  Input  File-Building  routine  (Part  IV) ,  which  builds  the  required  Wind 
Data  File  for  SHALWV.  (Note:  a  wind  data  file  is  required  for  all  SHALWV 
runs.  If  wind  input  is  not  desired,  the  windspeed  should  be  assigned  the 
integer  value  of  (1).)  The  third  file-building  function  routine  is  the 
Boundary  Condition  File-Building  routine  (Part  IV),  which  constructs  the 
optional  BCGEN  Input  File.  (The  BCGEN  program  is  used  to  generate  initial  and 
boundary  conditions  for  SHALWV  as  described  in  Parts  II  and  IV) . 

General  file  building  routine 

32.  The  General  File-Building  routine  is  used  to  construct  the  required 
General  Input  File,  Bathymetry  File,  Sheltering  File,  Parameter  File,  and  Main 
File  Name  File,  as  well  as  the  optional  Subgrid  Interpolation  File.  The 
General  Input  File,  Bathymetry  File,  Sheltering  File,  and  Subgrid  Inter¬ 
polation  File  are  briefly  described  below.  All  of  the  files  are  described  in 
Part  V.  The  General  Input  File  contains  the  following  information: 

a.  Program  flow  control  parameters. 

b.  Spectral  frequencies  and  direction  discretization  parameters. 

c.  Computational  grid  parameters. 

d.  Land  or  water  identifiers  for  each  grid  node. 

e.  Node  locations  for  output  of  model  results. 

£•  Node  locations  for  input  and  output  boundary  condition  data. 

g.  Diffraction  information. 
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33.  The  Bathymetry  File  contains  a  water  depth  for  each  node  in  the 
grid.  The  user  may  build  the  file  interactively  through  the  General  File 
Building  routine,  in  which  the  user  is  prompted  for  a  water  depth  at  each 
node,  or  in  the  case  where  the  depths  are  constant,  the  user  is  prompted  for 
the  constant  depth  value.  The  user  may  also  build  the  bathymetry  file  on  a 
preferred  word  processor  and  then  specify  the  name  of  the  file  during  the  Gen 
eral  File  Building  routine.  Since  the  bathymetry  file  already  exists  in  this 
case,  the  General  File  Building  routine  will  save  the  name  of  the  file  for 
later  use  by  SHALWV.  The  format  for  the  bathymetry  file  is  given  in  Part  V. 

34.  The  Sheltering  Input  File  specifies  node  locations  that  are 
sheltered  from  waves  by  an  obstruction,  such  as  an  island  or  peninsula,  and 
the  percentage  to  which  the  nodes  are  sheltered.  Similar  to  the  Bathymetry 
File  information,  the  sheltering  information  may  be  entered  interactively 
during  the  General  File  Building  session  or  by  specifying  an  existing  file 
that  contains  the  information. 

35.  The  Subgrid  Interpolation  File  is  used  by  the  boundary-condition 
interpolation  program,  INTERP  (see  Parts  II  and  V),  to  reduce  boundary  condi¬ 
tions  obtained  from  the  original  SHALWV  simulation  to  the  scale  of  a  subse¬ 
quent  subgrid  simulation. 

Data  descriptions  for  eeneral  SHALWV  files 


36.  Descriptions  of  the  data  required  during  the  General  File  Building 
session  are  provided  below.  The  descriptions  are  provided  as  follows:  the 
"Question:"  is  provided  as  it  appears  on  the  user's  terminal  during  the 
interactive  file-building  session  along  with  an  identifying  number  for 
reference  (e.g.  GF-1).  Then,  a  list  of  "Options:"  which  may  be  used  to  answer 
the  question  are  provided.  If  the  question  requires  a  limited  response,  then 
the  range  of  values  allowed  is  given.  A  list  of  previous  questions  that 
determine  whether  the  current  question  is  asked  is  presented  under  "Prese¬ 
lect:".  For  example,  question  GF-6  will  not  be  asked  unless  the  user  previ¬ 
ously  selected  option  1  or  3  on  question  GF-2  and  also  option  1  on  question 
GF-3.  While  all  of  the  questions  that  could  be  asked  by  the  module  are  listed 
below,  not  all  of  them  will  be  asked.  In  fact,  no  simulation  will  ever 
require  answers  to  ALL  of  the  questions.  Each  question  is  explained  under  the 
"Define:"  section,  and  a  list  of  "Cautions:"  are  provided  to  alert  users  to 
special  requirements  of  the  module.  Finally  a  "PATH:"  is  provided  that 
indicates  which  question  is  next  based  on  your  previous  option  selections. 


GF-1  Question 
Options 

Preselect: 

Define 


Caution 


GF-2  Question 
Options 


Preselect : 
Define  : 


Caution 


GF-3  Question 


Enter  SCREEN  WIDTH  OPTION  > 

1-80  Characters. 

2  -  132  Characters. 

None . 

The  setup  for  the  display  width  of  your  screen  is  necessary 
to  keep  output  matrices  from  "wrapping"  around  on  the  screen 
or  from  being  truncated  on  the  screen  during  the  summary 
review  of  data  at  the  end  of  the  General  File  Building 
Session.  An  incorrect  selection  will  not  affect  creation  of 
the  General  Input  File. 

If  you  select  a  132-character  screen  width  when  screen  is 
only  80  characters ,  matrix  output  displayed  during  input 
summary  at  end  ofthe  General  File  Building  session  will  be 
wrapped  around  on  the  screen  or  truncated.  This  will  only 
affect  data  viewing  and  not  the  data  itself. 

Enter  PROCESS  OPTION  > 

1  -  Create  preprocess  file  and  stop. 

2  -  Calculate  wave  field  only. 

3  -  Preprocess  and  calculate  wave  field. 

None . 

When  multiple  simulations  of  SHALWV  are  needed,  it  may  be 
cost  and  time  effective  to  compute  the  time -independent 
variables  once  for  the  entire  grid  and  store  those  values  in 
a  preprocess  file.  Then,  when  SHALWV  is  run  to  compute  the 
wave  fields,  the  time -independent  data  can  be  read  from  the 
preprocess  file,  and  only  the  time -dependent  variables  are 
computed  during  the  subsequent  simulation.  When  only  two  or 
three  SHALWV  simulations  are  needed,  it  may  be  better  to 
preprocess  and  run  SHALWV  in  the  same  execution. 

The  time- independent  variables  include  the  phase  and  group 
speed  of  each  discrete  spectral  energy  band.  Therefore,  if 
such  variables  are  constant  from  one  simulation  to  the  next 
(i.e.,  if  the  spectral  discretization  and  bathymetry  infor¬ 
mation  are  not  changed) ,  then  the  values  may  be  prepro¬ 
cessed. 

If  you  select  option  2,  questions  GF-4  through  GF-25  will  be 
skipped. 

Do  not  select  Option  2  if  a  preprocess  file  from  a  previous 
simulation  does  not  exist.  Otherwise,  a  file  error  will 
occur  when  the  module  tries  to  find  and  read  the  file. 

Winds  and  boundary  conditions  may  only  be  generated  with  the 
module  when  options  2  or  3  are  selected,  never  with  op¬ 
tion  1. 

Enter  the  Sub-Grid  Option  > 
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Options  1  -  Not  a  subgrid  simulation. 

2  -  Subgrid  simulation. 

Preselect:  None. 

Define  If  this  is  a  subgrid  simulation  of  an  original  SHALWV  simu¬ 

lation,  then  enter  a  two  (2).  If  this  is  not  a  subgrid 
simulation  or  if  this  is  the  original  simulation  prior  to  a 
subgrid  simulation,  then  enter  a  one  (1).  (See  discussion 
of  subgrids  in  Part  II). 

Sometimes  SHALWV  is  run  to  compute  waves  over  a  large  area 
in  order  to  determine  wave  information  at  certain  coastal 
locations.  To  make  SHALWV  economical  to  run  for  such  cases, 
the  size  of  the  computational  grid  cells  is  generally  large. 
SHALWV,  then,  provides  wave  information  at  points  that  are 
far  apart.  If  more  detailed  wave  information  is  needed  at  a 
particular  location  in  the  grid,  say  the  location  of  a 
coastal  project,  then  a  subgrid  of  the  original  larger  grid 
is  used  to  refine  the  wave  information  in  the  region  of 
interest.  (See  Figure  7-6.)  The  SHALWV  is  then  run  for  the 
subgrid  using  output  information  from  the  original  grid  as 
boundary  conditions  for  the  subgrid. 

See  question  GF-27  for  necessary  specifications  of  input  and 
output  boundary  conditions  for  the  subgrid  and  original  grid 
simulations . 

Cautions  :  If  the  subgrid  option  is  selected,  then  the  General  Input 

File  from  the  original  SHALWV  simulation  must  exist.  If  it 
does  not  exist,  an  error  will  result.  You  may  be  unaware  of 
the  files  that  are  being  built  and  used  by  SHALWV,  and 
therefore,  you  may  not  know  whether  the  General  Input  File 
for  the  original  SHALWV  simulation  exists.  However,  if  you 
made  the  original  SHALWV  simulation  prior  to  the  subgrid 
simulation  with  no  other  simulations  in  between  and  you  did 
not  delete  or  remove  any  files  from  your  directory,  then  the 
General  Input  File  exists. 

If  this  is  a  subgrid  run,  then  the  boundary  conditions  saved 
from  the  original  grid  must  be  interpolated  using  the  INTERP 
program  prior  to  running  SHALWV.  The  program  INTERP  should 
be  run  upon  completion  of  the  General  File  Building  routine. 

PATH:  o  IF  CALCULATING  WAVES  ONLY  (Option  2,  question  GF-2),  THEN  GO  TO 

GF-26 

GF-4  Question  Enter  number  of  COLUMNS  in  Grid  > 

Options  :  Range  3  -  100 

Preselect:  GF-2,  option  1  or  3 

Define  Figure  7-5  defines  the  columns  of  the  computational  grid. 

Cautions  :  None. 


GF-5  Question  Enter  number  of  ROWS  in  the  Grid  > 

Options  :  Range  3  -  100 
Preselect:  GF-2,  option  1  or  3 

Define  Figure  7-5  defines  the  rows  of  the  computational  grid. 

Cautions  :  None . 

PATH:  o  IF  SUBGRID  SIMULATION  (Option  2,  question  GF-3),  GO  TO  QUESTION 

GF-9 


GF-6  Question  Enter  number  of  FREQUENCY  BANDS  > 

Options  :  Range  10  •  20 

Preselect:  GF-2,  option  1  or  3;  GF-3,  option  1 

Define  A  wave  energy  spectrum  is  defined  according  to  wave  direc¬ 

tion  and  frequency.  An  infinite  number  of  frequency  and 
direction  bands  is  needed  to  define  the  wave  energy  spec¬ 
trum.  However,  modeling  an  infinite  number  is  not  feasible. 
The  energy  is  therefore  grouped  around  discrete  values  of 
direction  and  frequency.  You  must  select  the  number  of 
frequency  bands  to  define  the  wave  energy  spectrum. 

Caution  A  value  of  20  frequency  bands  is  recommended.  A  lower 

number  of  bands  decreases  the  resolution  of  the  wave  energy 
spectrum,  but  also  decreases  the  computation  time  for  the 
simulation. 

GF-7  Question  Enter  the  number  of  DIRECTION  BANDS  > 

Options  :  Range  16  -  36 

Preselect:  GF-2,  option  1  or  3;  GF-3,  option  1 

Define  This  is  the  same  as  question  GS-6  except  direction  bands  are 

stressed  instead  of  frequency  bands.  The  directional  bands 
encompass  a  360'  arc.  Therefore,  selection  of  16  direction 
bands  produces  direction  band  widths  of  22.5‘.  (Note:  the 
program  will  use  the  number  of  direction  bands  selected 
during  computations.  However,  only  16  direction  bands  are 
used  when  data  are  written  to  output  files) . 

Cautions  :  A  value  of  16  frequency  bands  is  recommended  for  most  simu¬ 
lations.  A  higher  number  of  bands  increases  the  resolution 
of  the  wave  energy  spectrum,  but  also  increases  the  computa¬ 
tion  time  for  the  simulation. 

GF-8  Question  Enter  FREQUENCY  BAND  COMPUTATION  OPTION  > 

Options  1  -  frequency  band  values  are  computed. 

2  -  frequency  band  values  are  entered  interactively. 

Preselect:  GF-2,  option  1  or  3;  GF-3,  option  1 
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Define 


Caution  : 
GF-9  Question 

Options  : 

Preselect: 

Define 


Cautions 
GF-10  Question 
Options 
Preselect 
Define 


Cautions  : 

GF-11  Question  : 
Options  : 
Preselect : 
Define 


Caution 


You  have  the  option  to  enter  the  frequency  band  values 
interactively  or  allow  the  computer  to  calculate  the  band 
values.  If  you  request  that  the  values  be  computed,  you 
will  be  prompted  (questions  GF-15  and  GF-16)  for  the  initial 
frequency  value  and  the  frequency  interval  between  bands. 

The  option  to  enter  the  frequency  band  values  interactively 
allows  you  to  input  frequency  values  that  are  not  separated 
by  a  constant  frequency  interval. 

None . 

Enter  WATER  DEPTH  INPUT  OPTION  > 

1  -  Spatially  constant  water  depth. 

2  -  Spatially  variable  water  depth. 

GF-2,  option  1  or  3 

The  bathymetry  of  the  model  area  may  be  specified  either  as 
constant  or  variable.  If  constant  depth  is  selected,  you 
will  be  prompted  for  the  depth  that  is  used  for  all  points 
on  the  computational  grid.  If  variable  depth  is  selected, 
you  will  have  the  option  to  input  the  depth  at  every  point 
on  the  computational  grid  either  interactively  or  by  speci¬ 
fying  a  file  which  contains  the  bathymetry  information.  If 
the  data  are  supplied  via  a  file,  you  will  be  prompted  for 
the  name  of  the  file. 

None. 

Enter  DEPTH  CONVERSION  FACTOR  > 

Variable . 

GF-2,  option  1  or  3 

The  depths  that  SHALWV  uses  must  be  in  units  of  meters. 
Therefore,  a  conversion  factor  must  be  entered,  allowing 
SHALWV  to  convert  your  depth  information  to  meters .  For 
example,  if  your  input  depths  are  given  in  feet,  then  a 
conversion  factor  of  0.3048  (m/ft)  must  be  entered. 

If  your  bathymetry  data  are  given  in  meters,  then  enter  a 
value  of  1.0  as  a  conversion  factor. 

Enter  DISTANCE  BETWEEN  GRID  POINTS  (km)  > 

>  0 

GF-2,  option  1  or  3 

You  must  input  the  length  (in  kilometers)  of  the  computa¬ 
tional  grid  cells  being  used.  The  cells  are  assumed  to  be 
uniform  and  square. 

Note  that  the  size  of  the  grid  cells  influences  the  size  of 
the  computational  time -step  allowed  based  on  the  Courant 
Stability  Criterion  (Equation  7-1  in  Part  II).  The  computa¬ 
tional  time-step  is  entered  by  question  GF-13. 
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GF-12  Question  :  Enter  the  REFRACTION  SCALE  FACTOR  > 

Options  Range  1  -  100 

Preselect:  GF-2,  option  1  or  3 

Define  Represents  the  scale  factor  used  to  compute  the  refraction 

of  the  wave  ray  as  shown  in  Figure  7-1  in  Part  II. 

Caution  A  refraction  scale  factor  of  10  is  recommended  for  accuracy 
and  efficiency.  A  larger  value  will  increase  computation 
time  and  computer  charges,  while  increasing  accuracy. 

GF-13  Question  :  Enter  COMPUTATIONAL  TIME  STEP  (sec)  > 

Options  :  >  0 

Preselect:  GF-2,  option  1  or  3;  GF-12 

Define  :  The  computational  time -step  is  the  amount  of  time  in  seconds 
between  each  computation.  The  value  is  related  to  the 
distance  between  grid  points  (question  GF-11)  and  the  great¬ 
est  depth  on  the  computational  grid.  The  computational  time 
step  must  be  small  enough  to  keep  the  modeling  calculations 
stable.  (See  the  discussion  of  the  Courant  Stability  Crite¬ 
ria  in  Part  II)  From  a  physical  point  of  view,  the  time- 
step  should  be  smaller  than  the  time  it  takes  for  the  lowest 
frequency  energy  to  propagate  across  the  deepest  grid  cell. 

If  you  do  not  know  what  time-step  is  satisfactory  for  your 
application,  the  following  procedure  can  be  used  to  deter¬ 
mine  an  appropriate  time-step.  For  arbitrary  depths,  calcu¬ 
late  the  group  speed  of  the  lowest  spectral  frequency  (ques¬ 
tion  GF-14  or  GF-15)  for  deepwater  conditions.  Multiply  by 
1.2  and  divide  by  the  grid  cell  size  (question  GF-11)  with 
dimensions  converted  to  meters.  The  data  summary  produced 
at  the  end  of  the  General  File  Building  session  will  deter¬ 
mine  whether  your  selected  time-step  is  valid.  You  will 
also  be  provided  with  the  most  efficient  time-step  that 
could  be  used.  If  your  selected  time -step  is  too  high,  you 
will  be  given  an  opportunity  to  change  it.  If  your  selected 
time-step  is  significantly  lower  than  the  provided  time- 
step,  you  may  consider  increasing  your  selected  value  some¬ 
what  . 

Cautions  :  Select  a  time -step  that  is  some  integer  multiple  of  an  hour 
(e.g.  60,  200,  1800,  3600  sec).  This  will  facilitate  selec¬ 
tion  of  an  output  interval  for  SHALWV  results.  (See  ques¬ 
tion  GF-32  and  GF-39.) 

PATH:  o  IF  SUBGRID  SIMULATION  (Option  2,  question  GF-3)  AND  DEPTHS  ARE 

VARIABLE  (Option  2,  question  GF-9),  GO  TO  GF-17. 

o  IF  SUBGRID  SIMULATION  AND  DEPTHS  ARE  CONSTANT,  GO  TO  GF-21. 

o  IF  FREQUENCIES  BANDS  ARE  COMPUTED  (Option  1,  question  GF-8),  GO 

TO  GF-15. 
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GF-14  Question 

Options 

Preselect 

Define 


Cautions 


PATH :  o 

GF-15  Question 
Options 
Preselect 
Define 


Cautions 


Enter  the  FREQUENCY  BAND  VALUES  > 
Enter  value  #: 

>  0 


GF-2,  option  1  or  3;  GF-3,  option  1;  GF-6;  GF-8,  option  2 

The  frequency  band  values  are  entered  interactively,  one 
value  per  line.  Values  for  the  number  of  frequency  bands 
specified  in  Question  GF-6  will  be  requested.  The  frequency 
va1  do  not  have  to  have  equal  frequency  intervals. 

Frequency  values  should  be  in  units  of  Hertz  (Hz) .  If  the 
frequencies  are  not  entered  in  ascending  order,  you  will  be 
asked  to  reenter  the  frequencies  so  that  they  are  in  ascend¬ 
ing  order. 

The  range  of  frequency  values  should  span  the  range  of 
frequencies  that  will  contain  significant  wave  energy.  A 
reasonable  range  of  values  is  from  0.25  to  4  times  the  peak 
frequency.  For  example,  if  wave  conditions  that  are  calcu¬ 
lated  by  SHALWV  are  expected  to  have  a  peak  period  of 
10  sec,  then  the  peak  frequency  (inverse  of  the  peak  period) 
would  be  0.1  Hz.  Therefore,  the  frequencies  band  values 
should  range  between  0.025  and  0.4.  Note  that  the  lower  the 
value  of  the  first  frequency  band,  the  smaller  the  computa¬ 
tional  time -step  must  be,  and  the  longer  the  simulation  will 
take  to  complete. 

IF  FREQUENCY  BAND  VALUES  ARE  ENTERED  INTERACTIVELY  (Option  1, 
question  GF-8),  GO  TO  GF-17 

Enter  FIRST  FREQUENCY  band  value  > 

:  >  0 

:  GF-2,  option  1  or  3;  GF-3,  option  1;  GF-8,  option  1 

You  must  provide  a  starting  frequency  value  to  which  the 
module  will  add  frequency  increments  to  derive  all  of  the 
frequency  band  values.  (The  size  of  the  frequency  increment 
is  specified  in  question  GF-16.) 

The  range  of  frequency  values  should  span  the  expected  range 
of  frequencies  that  contain  significant  wave  energy.  A 
reasonable  range  of  values  is  from  0.25  to  4  times  the  peak 
frequency  (inverse  of  the  peak  period).  For  example,  if  the 
largest  wave  conditions  expected  to  be  calculated  by  SHALWV 
have  a  peak  period  of  10  seconds,  then  the  peak  frequency 
would  be  0.1  Hz.  Therefore,  the  frequencies  band  values 
should  range  between  0.025  to  0.4.  The  first  frequency  band 
value  is  0.025  Hz. 

First  frequency  value  must  be  greater  than  zero.  Note  that 
the  lower  the  value  of  the  first  frequency  band,  the  smaller 
the  computational  time -step  must  be  and  longer  the  simula¬ 
tion  will  take  to  complete. 
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GF-16  Question  :  Enter  the  FREQUENCY  BAND  INTERVAL  > 

Options  :  >  0 

Preselect:  GF-2,  option  1  or  3;  GF-3,  option  1;  GF-6;  GF-8,  option  1 

Define  You  must  provide  the  frequency  increment  value  for  computing 

the  frequency  band  values.  The  increment  value  is  cumula¬ 
tively  added  to  the  first  frequency  value  specified  in 
question  GF-15.  The  increment  value  must  be  such  that  when 
it  is  added  to  the  first  frequency  value  by  the  number  of 
frequency  bands  specified  in  question  GF-6,  the  resulting 
frequency  band  values  will  cover  the  necessary  range  of 
frequencies.  For  the  example  given  in  question  GF-15,  if 
there  were  20  frequency  bands  specified  in  question  GF-6, 
then  the  increment  needed  is  about  0.02  Hz  to  get  20  equally 
spaced  frequency  bands  between  0.025  to  0.4. 

Cautions  :  None. 

PATH:  o  IF  WATER  DEPTHS  ARE  CONSTANT  (Option  1,  question  GF-9),  GO  TO 

GF-21 . 

GF-17  Question  :  Are  WATER  DEPTHS  in  a  file?  (yes  or  no)  > 

Options  :  y  (Y)  -  yes,  water  depths  are  in  a  file. 

n  (N)  -  no,  water  depths  will  be  entered  interactively. 

Preselect:  GF-2,  option  1  or  3;  GF-9,  option  2 

Define  :  Water  depths  may  be  entered  from  a  file,  in  which  case  you 
will  be  prompted  for  the  file  name,  or  they  may  be  entered 
interactively,  in  which  case  you  will  be  prompted  for  each 
depth  value.  Water  depth  values  are  required  for  each  point 
in  the  computational  grid.  (Note:  Although  this  question 
is  asked  only  when  you  select  option  2  in  question  GF-9,  you 
may  enter  a  constant  water  depth  for  every  point  on  the 
computational  grid.  Option  1  in  question  GF-9  merely  makes 
input  of  a  constant  water  depth  simple.) 

Cautions  :  If  you  indicate  that  the  water  depths  are  in  a  file,  you 

will  be  prompted  for  the  name  of  the  file.  If  you  indicate 
that  the  water  depths  are  not  in  a  file,  you  will  be  expect¬ 
ed  to  enter  them  interactively. 

PATH:  o  IF  NO  WATER  DEPTH  FILE  (Option  'no',  question  GF-17),  GO  TO  GF- 

19 

GF-18  Question  :  Enter  the  WATER  DEPTH  FILE  name  > 

Options  Variable. 

Preselect:  GF-2,  option  1  or  3;  GF-9,  option  2;  GF-17,  option  "yes" 

Define  The  water  depth  file  contains  the  water  depth  values  for 

each  point  in  the  computational  grid.  The  values  must  exist 
in  the  file  in  a  "21F6.0"  format  (FORTRAN).  If  your  grid 
has >more  than  21  points  per  row,  then  enter  the  first  21 
points  on  one  line  of  the  data  file,  and  the  remaining 
points  (up  to  21)  on  the  next  line,  and  so  on  until  all 
values  for  a  row  are  entered.  A  new  row  begins  a  new  line 
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in  the  data  file.  Figure  7-5  shows  the  orientation  of  the 
grid  and  the  corresponding  orientation  of  the  water  depth 
data.  Water  depths  must  be  entered  as  positive  numbers 
while  land  points  are  negative. 

While  building  the  water  depth  file,  land  should  be  identi¬ 
fied  by  a  depth  value  less  than  or  equal  to  zero  (0.0)  to 
facilitate  automatic  generation  of  the  Land/Water  grid 
(question  GF-22). 

Cautions  :  The  water  depth  file  name  must  conform  to  the  file  naming 

conventions  of  the  UNIX  operating  system  (only  the  first  14 
characters  are  significant).  The  units  of  the  water  depth 
data  must  be  consistent  with  the  conversion  factor  entered 
in  question  GF-10.  The  number  of  depth  data  values  must  be 
identical  to  the  number  of  grid  points  (questions  GF-4  and 
GF-5) . 

PATH:  o  IF  WATER  DEPTH  FILE  (Option  'yes',  question  GF-17),  GO  TO  GF- 

22. 

GF-19  Question  :  Build  the  water  depth  file?  (yes  or  no)  > 

Options  y  (or  Y)  -  water  depth  values  entered  interactively. 

n  (or  N)  -  water  depth  values  not  entered  interactively. 

Preselect:  GF-2,  option  1  or  3;  GF-9,  option  2;  GF-17,  option  "no" 

Define  :  Indicate  whether  you  are  ready  to  begin  building  the  water 

depth  file.  If  you  indicate  yes,  the  module  will  prompt  you 
for  water  depth  values  for  each  point  on  the  computational 
grid. 

Cautions  :  If  you  indicate  that  the  water  depth  file  will  not  be  built 
interactively,  then  the  General  File  Building  session  will 
end  and  no  information  will  be  saved.  You  will  be  required 
to  rerun  the  General  File  Building  routine. 

GF-20  Question  :  Enter  the  WATER  DEPTH  MATRIX  > 

Enter  the  value  for  ROW  -  ##,  COL  -  ##: 

Options  :  Variable . 

Preselect:  GF-2,  option  1  or  3;  GF-9,  option  2;  GF-17,  option  "no"; 
GF-19,  option  "yes". 

Define  :  Begin  entering  the  water  depth  values  for  the  specified  grid 
points.  Figure  7-5  shows  the  orientation  of  the  grid  and 
the  corresponding  orientation  of  the  water  depth  data. 

While  building  the  water  depth  file,  keep  in  mind  that  land 
should  be  identified  by  a  value  less  than  or  equal  to  zero 
(0.0).  This  will  facilitate  automatic  generation  of  the 
Land/Water  matrix  (question  GF-22). 

Cautions  :  The  water  depth  values  must  be  entered  as  positive  numbers, 
and  the  units  must  be  consistent  with  the  depth  conversion 
factor  entered  in  question  GF-10.  You  will  not  be  given  an 
opportunity  to  correct  the  depth  data  once  you  have  entered 
them . 


PATH:  o  IF  VARIABLE  HATER  DEPTHS  (Option  2,  question  GF-9),  GO  TO  GF- 

22. 

GF-21  Question  :  Enter  CONSTANT  HATER  DEPTH  > 

Options  >  0 

Preselect:  GF-2,  option  1  or  3;  GF-9,  option  1 

Define  For  applications  where  the  depths  can  be  assumed  constant, 

entering  a  single  water  depth  value  for  all  points  on  the 
computational  grid  is  possible.  For  example,  in  cases  where 
all  points  are  considered  to  be  in  deep  water  relative  to 
the  lowest  frequency  band  value  (see  question  GF-14  or  GF- 
15),  it  may  be  convenient  to  enter  a  single,  large  depth 
value  for  all  points  of  the  grid  (e.g.  9999  ft). 

Cautions  :  The  depth  value  must  be  consistent  with  the  depth  conversion 

factor  entered  in  question  GF-10. 

GF-22  Question  :  Enter  the  LAND/HATER  MATRIX  OPTION  > 

Options  1  -  Enter  the  matrix  interactively. 

2  -  Read  the  matrix  from  a  file. 

3  -  Generate  test  matrix. 

4  -  Compute  matrix  from  water  depth  file. 

Preselect:  GF-2,  option  1  or  3 

Define  :  The  Land/Water  matrix  contains  flags  (ones  (1)  and  zeros  (0) 
to  distinguish  land  (0)  from  water  (1)  on  the  computational 
grid.  The  orientation  of  the  ones  and  zeroes,  corresponding 
to  points  on  the  grid,  must  conform  to  the  grid  orientation 
identified  in  Figure  7-5. 

If  you  elect  to  enter  the  matrix  interactively,  you  will  be 
prompted  for  a  one  (1)  or  zero  (0)  value  for  each  point  on 
the  computational  grid.  If  you  elect  to  enter  the  matrix 
from  a  file,  you  will  be  prompted  for  the  file  name  contain¬ 
ing  the  matrix.  The  module  checks  for  inconsistencies 
between  the  values  for  land/water  points  that  you  enter 
(interactively  or  by  file)  and  the  water  depth  information 
entered  previously.  The  entered  land/water  values  will  be 
corrected  to  reflect  the  correct  bathymetry  information. 

That  is,  land  points  specified  as  a  one  (1)  will  be  changed 
to  a  zero  (0)  and  vice  versa. 

If  you  elect  to  use  the  test  matrix,  a  matrix  will  be  creat¬ 
ed  containing  all  ones  (1)  except  for  zeroes  (0)  along  the 
boundaries  of  the  grid. 

If  you  elect  to  let  the  module  create  the  matrix  from  the 
water  depth  file.,  then  the  water  depth  values  will  be  evalu¬ 
ated,  and  every  grid  point  with  a  depth  value  less  than  or 
equal  to  zero  (0.0)  will  be  assigned  a  value  of  zero  (0)  and 
every  point  with  a  depth  value  greater  than  zero  will  be 
assigned  a  value  of  one  (1).  Also,  zeroes  (0)  will  be 
assigned  to  any  point  along  the  boundary  of  the  grid. 
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Cautions  :  If  you  elect  to  enter  the  matrix  from  a  file  and  the  file 
does  not  exist  or  the  values  within  the  matrix  are  not  in 
the  proper  format  (see  Part  V) ,  the  General  File  Building 
session  will  end.  No  information  will  be  saved.  You  must 
correct  the  file  before  rerunning  the  General  File  Building 
routine. 

PATH:  o  IF  LAND/WATER  MATRIX  ENTERED  INTERACTIVELY  (Options  1,  question 

GF-22) ,  GO  TO  GF-25. 

o  IF  LAND/VATER  TEST  MATRIX  DESIRED  OR  TEST  (Option  3,  question 

GF-22),  GO  TO  GF-26. 

o  IF  LAND/VATER  MATRIX  IS  GENERATED  FROM  BATHYMETRY  DATA  (Option 

4,  question  GF-22),  GO  TO  26 

GF-23  Question  :  Is  there  a  LAND/VATER  file?  (yes  or  no)  > 

Options  y  (or  Y)  -  file  containing  the  Land/Water  data  exists, 
n  (or  N)  -  Land/Water  file  does  not  exist. 

Preselect:  GF-2,  option  1  or  3;  GF-22,  option  2 

Define  :  If  the  Land/Water  file  exists,  you  will  be  prompted  for  the 
name  of  the  file. 

Cautions  :  If  you  answer  yes  and  the  file  does  not  exist  or  the  data 
are  not  formatted  properly,  or  if  you  answer  no,  then  the 
General  File  Building  routine  will  end.  No  information  will 
be  saved.  You  will  be  required  to  rerun  the  General  File 
Building  routine  from  the  beginning. 

GF-24  Question  :  Enter  the  LAND/VATER  file  name  > 

Options  :  Variable. 

Preselect:  GF-2,  option  1  or  3;  GF-22,  option  2;  GF-23,  option  "yes" 

Define  :  The  Land/Water  file  name  must  be  provided  so  that  the  module 
can  read  it  to  obtain  the  Land/Water  matrix.  If  a  satisfac¬ 
tory  name  is  provided,  the  module  reads  the  file.  If  the 
Land/Water  file  is  read  successfully,  a  message  is  issued 
indicating  such.  See  Part  V  for  a  description  of  the  re¬ 
quired  data  format  for  the  Land/Water  File. 

Cautions  :  If  an  error  is  encountered  while  the  module  reads  the 

Land/Water  File,  then  a  message  is  issued  indicating  such 
and  the  General  File  Building  session  will  end.  No  infor¬ 
mation  will  be  saved,  and  you  will  be  required  to  correct 
the  Land/Water  file  and  rerun  the  General  File  Building 
routine . 

The  Land/Water  File  name  must  conform  to  the  file  naming 
conventions  of  the  UNIX  operating  system  (only  the  first 
14  characters  are  significant). 

PATH:  o  IF  LAND/VATER  MATRIX  ENTERED  FROM  A  FILE  (Option  2,  question 

GF-22),  GO  TO  26. 

GF-25  Question  :  Enter  the  LAND/VATER  matrix  > 

Enter  the  value  for  ROV  -  ##,  COL  «■  ##: 
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Options  Variable. 

2Preselect:  GF-2,  option  1  or  3;  GF-22,  option  1 

Define  A  one  (1)  or  zero  (0)  oust  be  entered  for  each  point  on  the 

computational  grid  specified  by  the  ROW  and  COLUMN  values. 

A  one  indicates  that  the  point  is  water,  while  a  zero  indi¬ 
cates  that  the  point  is  land.  The  border  of  the  grid  must 
be  labeled  with  zeroes. 

Cautions  :  If  the  points  on  the  border  of  the  grid  are  not  assigned 
values  of  zero,  SHALWV  will  not  run  successfully. 

PATH:  o  IF  PREPROCESSING  ONLY  (Option  1,  question  GF-2),  GO  TO  GF-53. 

GF-26  Question  :  Enter  START-UP  OPTIONS  > 

Options  1  -  Cold  start,  no  save. 

2  -  Warm  start,  no  save. 

3  -  Cold  start,  save. 

4  -  Warm  start,  save. 

Preselect:  GF-2,  option  2  or  3 

Define  There  are  times  when  a  series  of  related  SHALWV  simulations 

are  required  to  perform  a  long  simulation.  For  example, 
hindcasting  wave  conditions  for  a  10 -year  period  could  not 
be  done  with  a  single  SHALWV  simulation  because  the  data 
that  would  be  retained  during  the  simulation  would  be  too 
extensive  for  the  computer  to  maintain.  Instead,  the  hind- 
cast  would  be  conducted  in  short  segments,  each  possibly  1 
month  long.  To  maintain  consistency  between  each  simula¬ 
tion,  the  wave  conditions  from  the  last  computational  period 
in  one  simulation  would  be  used  to  initialize  wave  condi¬ 
tions  for  the  next  simulation.  Such  an  initialization  of  a 
simulation  is  called  a  "warm  start." 

Option  1  indicates  that  no  previous  SHALWV  simulation  re¬ 
sults  will  be  used  to  initialize  the  current  SHALWV  simu¬ 
lation  and  no  results  will  be  saved  for  initializing  any 
subsequent  simulations.  Option  2  indicates  that  the  results 
from  a  previous  SHALWV  simulation  will  be  used  to  initialize 
the  current  SHALWV  simulation  and  that  results  will  not  be 
saved  for  initializing  any  subsequent  simulations.  Option  3 
is  the  same  as  option  1  except  that  results  from  the  current 
SHALWV  simulation  will  be  used  to  initialize  a  subsequent 
SHALWV  simulation.  Option  4  is  the  same  as  option  2  except 
that  results  from  the  current  SHALWV  simulation  will  be  used 
to  initialize  a  subsequent  SHALWV  simulation. 

If  you  are  going  to  run  SHALWV  several  times  using  the 
output  from  one  simulation  to  initialize  the  next  simula¬ 
tion,  then  the  first  simulation  would  have  option  "Cold 
start,  save"  and  the  last  simulation  would  have  option  "Warm 
start,  no  save."  All  of  the  simulations  in  between  would 
use  the  option  "Warm  start,  save." 
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Cautions  : 


GF-27  Question  : 
Options  : 


Preselect: 


Define 


To  use  the  warm  start  option,  the  results  from  a  previous 
simulation  have  to  be  saved  using  the  "Cold  start,  save"  or 
"Warm  start,  save"  option. 

The  wind  and  boundary  condition  data  must  overlap  by  one 
input  time  interval.  That  is,  the  last  wind  and  boundary 
condition  values  entered  in  the  previous  simulation  must  be 
repeated  as  the  first  wind  and  boundary  conditions  in  the 
next  simulation. 

Enter  BOUNDARY  CONDITION  OPTION  > 

1  -  No  input  or  output  boundary  conditions. 

2  -  Output  boundary  condition  information. 

3  -  Input  boundary  condition  information. 

4  -  Input  and  output  boundary  information. 

GF-2,  option  2  or  3 

Input  Boundary  and  Initial  Conditions. 

When  simulating  wave  conditions  for  a  point  on  an  open 
coast,  the  entire  ocean  basin  may  have  to  be  modeled  to 
determine  the  proper  wave  conditions  that  propagate  into  the 
region  of  interest  from  other  regions  during  the  simulation. 
To  circumvent  such  limitations,  input  boundary  conditions 
may  be  used  that  allow  you  to  initialize  the  wave  conditions 
over  the  entire  computational  grid  at  the  start  of  the 
simulation  and  force  input  of  wave  energy  spectra  at  the 
boundaries  of  the  grid  through  the  remainder  of  the  simula¬ 
tion.  (A  special  case  where  input  boundary  conditions  are 
required  is  for  subgrid  simulations  (question  GF-3).  See 
the  discussion  below  regarding  output  boundary  conditions 
for  subgrids.) 

The  generation  and  transformation  of  input  boundary  data 
(input  wave  energy  spectra)  are  conducted  by  the  program 
BCGEN,  which  is  discussed  in  Part  IV.  The  BCGEN  program 
must  be  run  prior  to  SHALWV, 

Initial  conditions  for  the  entire  grid  must  also  be  speci¬ 
fied  with  any  input  boundary  condition  specification.  The 
Initial  conditions  provide  a  means  of  prescribing  a  given 
sea  state  over  the  entire  grid  prior  to  the  start  of  the 
simulation,  which  can  greatly  reduce  the  computational  time 
required  to  bring  the  sea  state  up  to  the  given  condition. 
For  example,  assume  a  major  weather  system  generates  energy- 
based  wave  heights  of  about  7  m  within  a  5-hr  period  and 
24  hr  prior  to  the  peak  of  the  storm,  waves  in  excess  of  2  m 
existed,  and  48  hr  before  that,  the  wave  heights  were  ap¬ 
proximately  0.5  m.  You  would  want  to  start  the  simulation 
at  the  time  of  the  0.5-m  wave  conditions  so  that  the  model 
has  sufficient  time  to  generate  a  sea  state  similar  to  the 
actual  sea  state  before  the  weather  system  of  interest 
arrives.  However,  such  a  simulation  would  require  a  signif¬ 
icant  amount  of  computational  time.  A  better  way  to  model 
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the  scenario  would  be  to  initialize  the  sea  state  to  approx¬ 
imately  2.0  m  at  the  start  of  the  simulation.  Very  little 
computational  time  would  be  required  to  bring  the  simulated 
sea  state  to  the  level  of  the  actual  sea  state. 

Initial  conditions  are  given  by  specifying  the  wave  spectrum 
using  the  TMA  spectral  form  (Bouws  et  al.  1984).  The  user 
must  provide  values  for  the  five  parameters  that  control  the 
size  and  shape  of  the  spectrum.  The  parameters  are  fa  , 
a  ,  7  ,  am  ,  and  ob  ,  which  are  defined  by: 


E(f) 


=  iLSf  f-s 


2x 


exp 


-1.25 


Y  exp 


-< f-f.y 


2  o2f2 


<t>  (2 xf.h) 


where 

g  -  gravitational  acceleration 
f  -  frequency  band  valve 
fm  -  peak  spectral  frequency  band  value 
h  -  water  depth 

a  -  Phillip’s  Equilibrium  Constant 
7  -  spectral  peakedness  factor 

<7a  -  spectral  peak  width  to  the  low-frequency  side 
ab  -  spectral  peak  width  to  the  high-frequency  side 


and  <j>  is  given  by: 


<t>(2  nf.h) 


[*(«„>  r2 


2(Jb  R{uh) 
sinh[2«b  R(uh)  ]  t 


where 


and  R( wj,)  is  found  by  iteration  with: 


R(oh)  tanh[o)b  i?(oA)]  =  2 

The  method  recommended  for  selecting  the  parameters  is  as 
follows : 

a.  Let  y-3.3,  oa  -  0.07,  ab  -  0.09,  and  fm  -  the 
peak  spectral  frequency  desired. 
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Iterate  on  values  of  a  that  provide  the  desired 
wave  height  condition  (#„)  given  by: 


If  initial  conditions  are  not  desired,  select  a  frequency 
value  for  fa  that  is  much  larger  than  the  peak  frequency 
of  the  input  boundary  conditions. 

Output  Bvwvtary  CvnfliUgng. 

If  a  subgrid  simulation  (question  GF-3)  will  follow  the 
current  SHALWV  simulation,  then  output  boundary  conditions 
must  be  saved  from  the  current  simulation  to  act  as  input 
boundary  conditions  for  the  subgrid  simulation.  (See  Part 
II  for  a  description  of  a  subgrid  simulation.)  The  output 
boundary  conditions  will  be  applied  at  points  along  the 
boundary  of  the  subgrid.  The  boundary  conditions  will  be 
interpolated  and  transformed  over  the  subgrid  by  the  INTERP 
program,  which  is  discussed  in  Part  IV.  The  INTERP  program 
must  be  run  prior  to  SHALWV. 

Cautions  :  If  the  current  simulation  is  a  subgrid  simulation  (see 
question  GF-3),  then  input  boundary  conditions  must  be 
specified  using  the  output  boundary  conditions  from  the 
original  SHALWV  simulation.  If  you  do  not  select  either  of 
the  input  boundary  condition  options  (options  3  or  4) ,  then 
the  module  will  select  it  for  you.  That  is,  if  you  select 
option  1,  it  will  be  changed  to  option  3.  If  you  select 
option  2,  it  will  be  changed  to  option  4.  A  message  will  be 
issued  indicating  a  change  has  been  made  to  your  original 
selection. 

Similarly,  if  the  current  simulation  is  the  original  large 
grid  for  a  later  subgrid  simulation,  then  you  must  specify 
options  2  or  4.  If  you  do  not  choose  options  2  or  4,  the 
module  will  not  change  your  selection  and  you  will  not  be 
able  to  conduct  the  later  subgrid  simulation. 

GF-28  Question  :  Enter  the  WIND  INPUT  OPTION  > 

Options  :  1  -  Constant  over  time  and  space. 

2  -  Variable  over  time,  constant  over  space. 

3  -  Variable  over  time  and  space. 

Preselect:  GF-2,  option  2  or  3 

Define  Constant  winds  are  winds  that  do  not  vary  in  time  or  space 

during  the  simulation.  One  value  is  used  for  wind  speed  and 
one  value  for  wind  direction  for  the  entire  simulation.  (If 
winds  are  not  desired  for  the  simulation,  option  1  should  be 
selected.  Then,  during  the  Wind  File  Building  session,  a 
constant  wind  speed  value  of  1  knot  should  be  entered.) 

The  second  wind  data  option  requires  winds  that  vary  in 
time,  but  are  constant  in  space.  That  is,  for  a  given  time, 
every  point  on  the  computational  grid  will  have  the  same 
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wind  speed  and  direction.  This  option  makes  entering  wind 
conditions  simple  for  simulations  in  which  the  water  body  is 
small  enough  that  the  winds  can  be  considered  the  same  at 
every  point  in  the  grid. 

The  third  wind  data  option  requires  winds  that  are  variable 
in  time  and  space.  That  is,  each  point  on  the  computational 
grid  may  experience  winds  that  are  different  from  winds 
experienced  at  other  points  at  any  given  time. 

Cautions  :  After  the  General  File  Building  session  is  completed,  a  Wind 
File  Building  session  MUST  be  conducted  during  which  you 
will  be  prompted  for  wind  speeds  and  directions  based  on 
whichever  Wind  Input  Option  you  select.  If  you  select 
option  1,  you  will  be  expected  to  enter  the  wind  speed  and 
direction  interactively.  If  you  select  option  2,  you  will 
be  expected  to  enter  the  wind  speeds  and  directions  for  each 
wind  input  time-step  (see  question  GF-33)  either  interac¬ 
tively  or  using  a  data  file.  If  you  select  option  3,  you 
will  be  expected  to  input  the  wind  data  through  a  data  file 
only.  The  format  of  the  wind  data  in  the  data  files  is 
discussed  in  Part  V. 

GF-29  Question  :  Enter  BOTTOM  EFFECTS  OPTION  > 

Options  :  1  -  No  bottom  effects. 

2  -  Bottom  effects. 

Preselect:  GF-2,  option  2  or  3 . 

Define  :  SHALWV  allows  you  to  represent  the  effects  of  the  sea  bed  on 
wave  conditions  during  the  simulation.  If  you  select  op¬ 
tion  2,  you  will  be  prompted  for  the  bottom  friction  coeffi¬ 
cient  and  the  bottom  percolation  factor. 

Cautions  :  None. 

PATH:  o  IF  NO  BOTTOM  EFFECTS  (Option  1,  question  GF-29),  GO  TO  GF-32. 

GF-30  Question  :  Enter  BOTTOM  FRICTION  COEFFICIENT  > 

Options  :  0.001  <  VALUE  <  0.015 

Preselect:  GF-2,  option  2  or  3;  GF-29,  option  2; 

Define  :  The  theoretical  development  of  the  bottom  frictional  energy 
loss  mechanism  was  derived  from  work  by  Hasselmann  and 
Collins  (1968).  They  validated  their  approach  using  a 
bottom  friction  coefficient  of  0.015  and  based  it  on  com¬ 
parisons  between  field  measurements  and  numerical  results 
for  a  hurricane  simulation.  It  is  not  clear  that  their 
value  of  0.015  is  accurate  because  they  may  have  substan¬ 
tially  overestimated  the  atmospheric  input  and  required  a 
large  loss  mechanism  to  compare  more  favorably  to  measure¬ 
ments.  Experience  with  the  bottom  friction  term  in  SHALWV 
is  limited,  but  based  on  recent  work  and  the  approach  used 
by  Bouws  and  Komen  (1983),  the  value  for  the  bottom  friction 
coefficient  should  be  between  0.001  and  0.005. 

Cautions  :  None. 


7-38 


GF-31  Question 
Options 
Preselect 
Define 


Cautions 
GF-32  Question 
Options 
Preselect 
Define 


Cautions  : 


Enter  BOTTOM  PERCOLATION  FACTOR  (cm/sec)  > 

0.0  <  VALUE  s;  2.0 

GF-2,  option  2  or  3;  GF-29,  option  2; 

The  formulation  of  the  bottom  percolation  energy  loss  term 
comes  directly  from  working  Hsiao  (1978),  which  was  also 
published  by  Shemdin  et  al.  (1980).  From  work  conducted  by 
Sleath  (1970),  the  bottom  percolation  coefficients  recom¬ 
mended  are: 

Coarse  Sand  1.26  cm/sec 
Fine  Sand  0.145  cm/sec 

Experience  with  the  bottom  percolation  factor  in  SHALWV  is 
limited.  The  amount  of  energy  loss  produced  by  the  bottom 
percolation  factor  is  uncertain. 

None . 

Enter  NUMBER  OF  TIME  STEPS  between  output  > 

>  0 

GF-2,  option  2  or  3 

The  results  from  SHALWV  are  provided  at  each  time  interval 
specified.  The  results  include  matrices  of  the  wave  charac¬ 
teristics  (energy-based  wave  height,  peak  spectral  period, 
and  mean  spectral  propagation  direction)  for  the  entire 
grid,  the  wave  characteristics  (including  those  for  the 
wind- sea  portion  of  the  spectrum,  the  swell  portion  of  the 
spectrum  and  the  total  spectrum,  as  well  as  the  wind  speed 
and  direction)  and  spectral  energy  values  for  specified  grid 
locations  (question  GF-35).  Descriptions  and  partial  exam¬ 
ples  of  output  files  are  provided  in  Part  V. 

The  model  time-step  size  is  specified  in  question  GF-13. 

The  interval  used  to  output  SHALWV  results  is  based  on  the 
computational  time-step.  For  example,  if  the  computational 
time-step  is  3  min  (180  sec)  and  output  results  are  desired 
at  hourly  intervals ,  then  you  would  enter  the  value  20  for 
this  question,  that  is,  every  20  time -steps  you  want  SHALWV 
results.  (See  question  GF-36  for  a  discussion  specifying 
output  locations . ) 

Note  that  the  question  does  not  ask  for  the  amount  of  time 
between  output  intervals  but  the  number  of  computational 
time-steps  that  occur  between  output  intervals. 

When  specifying  the  computational  time-step  (question  GF- 
13),  it  is  recommended  that  the  time-step  be  some  integer 
factor  or  multiple  of  1  hr  (3,600  sec).  That  recommendation 
facilitates  this  question  in  that  it  allows  easy  specifica¬ 
tion  of  fractions  or  multiples  of  an  hour  for  output  of 
data. 

Note  that  the  smaller  the  interval  used  to  output  SHALWV 
results,  the  greater  the  volume  of  data  that  will  be  stored 
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in  files.  Also,  the  number  of  special  output  locations 
(question  GF-35)  influences  the  voluae  of  data  stored. 

GF-33  Question  :  Enter  NUMBER  OF  HOURS  BETWEEN  INPUT  WINDS  > 

Options  :  >  0 

Preselect:  GF-2,  option  2  or  3 

Define  The  wind  data  are  required  at  integer  multiples  of  an  hour. 

For  example,  wind  data  are  usually  provided  every  hour, 
every  3  hr,  or  some  other  multiple  of  an  hour.  Generally, 
the  wind  input  is  provided  at  intervals  greater  than  the 
computational  time-step  (question  GF-13).  Therefore,  the 
wind  input  data  are  interpolated  linearly  by  SHALWV  to 
derive  wind  information  for  each  computational  time-step. 

Cautions  :  If  input  boundary  conditions  are  specified  (question  GF-27), 
they  must  be  entered  at  the  same  interval  as  the  wind  data. 
If  this  is  a  subgrid  simulation,  the  input  boundary  con¬ 
dition  interval  is  specified  as  the  BOUNDARY  DATA  OUTPUT 
INTERVAL  (Question  GF-37)  in  the  original  SHALWV  simulation. 

GF-34  Question  :  Enter  NUMBER  OF  WIND  INPUT  VALUES  > 

Options  :  >  2 

Preselect:  GF-2,  option  2  or  3. 

Define  :  The  number  of  wind  input  values  actually  defines  the  length 
of  the  simulation.  For  example,  if  you  select  a  wind  input 
interval  of  1  hr  in  question  GF-33,  then  entering  24  for 
this  question  would  mean  that  the  simulation  is  for  24  hr. 

If  the  wind  input  interval  was  3  hr,  then  entering  24  for 
this  question  would  mean  that  the  simulation  is  for  72  hr, 
and  so  on. 

Cautions  :  None . 

GF-35  Question  :  Enter  NUMBER  OF  SPECIAL  OUTPUT  LOCATIONS  > 

Options  :  range  0  to  50 

Preselect:  GF-2,  option  2  or  3. 

Define  :  The  output  locations  are  those  points  on  the  computational 
grid  at  which  output  data  should  be  saved  by  SHALWV  to 
files.  These  output  data  are  not  the  same  as  the  output 
boundary  condition  data  discussed  in  question  GF-27. 
Description  of  the  SHALWV  results  are  provided  in  question 
GF-32  and  Part  V. 

Cautions  :  If  you  select  0,  SHALWV  results  will  not  be  saved  at  any 

special  locations.  If  you  select  a  value  between  1  and  50, 
you  will  be  prompted  for  the  ROW  and  COLumn  values  for  the 
output  locations  (question  GF-36). 

PATH:  o  IF  NO  SPECIAL  OUTPUT  LOCATIONS  (answer  'O',  question  GF-35)  AND 

THIS  IS  NOT  A  SUBGRID  SIMULATION  (Option  2,  question  GF-3)  AND 
NO  INPUT  OR  OUTPUT  BOUNDARY  CONDITIONS  ARE  SPECIFIED  (Option  1, 
question  GF-27),  GO  TO  GF-53. 
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o 

IF  NO  SPECIAL  OUTPUT  LOCATIONS  (answer  'O',  question  GF-35)  AND 

THIS  IS  A  SUBGRID  SIMULATION  (Option  2,  question  GF-3),  GO  TO 

GF-37. 

• 

o 

IF  NO  SPECIAL  OUTPUT  LOCATIONS  (answer  'O',  question  GF-35)  AND 

INPUT  BOUNDARY  CONDITIONS  SPECIFIED  WITHOUT  OUTPUT  BOUNDARY 

CONDITIONS  (Option  3,  question  GF-27),  GO  TO  GF-44. 

o 

IF  NO  SPECIAL  OUTPUT  LOCATIONS  (answer  'O',  question  GF-35)  AND 

OUTPUT  BOUNDARY  CONDITIONS  SPECIFIED  (Option  2  or  4,  GF-27),  GO 

TO  GF-39 . 

GF-36 

Question 

Enter  the  OUTPUT  LOCATIONS  (COLUMN  and  ROW)  > 

COLUMN  and  ROW  for  point  ###: 

Options 

:  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-34,  0  <  option  <  50. 

Define 

:  The  column  and  row  values  must  conform  to  the  orientation  of 
the  grid  as  defined  in  Figure  7-5.  If  you  enter  the  values 
incorrectly,  you  will  be  given  an  opportunity  to  correct 
them. 

Cautions 

:  Separate  the  entered  values  with  a  comma  ( , )  or  a  space  (  ) . 

The  module  will  not  check  whether  the  output  location  is  a 
land  or  water  point. 

PATH: 

o 

IF  NOT  A  SUBGRID  SIMUIATION  (Option  1,  question  GF-3)  AND  NO 

INPUT  OR  OUTPUT  BOUNDARY  CONDITIONS  SPECIFIED  (Option  1, 
question  GF-27),  GO  TO  GF-53. 

# 

o 

IF  NOT  A  SUBGRID  SIMULATION  (Option  1,  question  GF-3)  AND  INPUT 

BOUNDARY  CONDITIONS  SPECIFIED  WITHOUT  OUTPUT  BOUNDARY  CONDI¬ 
TIONS  (Option  3,  question  GF-27),  GO  TO  GF-44. 

o 

IF  NOT  A  SUBGRID  SIMULATION  (Option  1,  question  GF-3)  AND 

OUTPUT  BOUNDARY  CONDITIONS  SPECIFIED  (Option  2  or  4,  question 

GF-27),  GO  TO  GF-39. 

GF-37 

Question 

Enter  the  coordinates  in  the  subgrid  system  that  are  associ¬ 
ated  with  the  following  output  boundary  location  from  the 
original  grid. 

The  output  location  was  at: 

COLUMN  -  ##  ROW  -  ## 

Enter  the  corresponding  subgrid  coordinates  > 

Options 

:  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  2;  GF-27,  option  3  or  4. 

Define  :  The  subgrid  orientation  must  be  coordinated  with  the  original  grid 

orientation  as  shown  in  Figure  7-6.  This  is  accomplished  by 
matching  one  of  the  output  boundary  condition  points  from  the 
original  grid  with  the  corresponding  point  of  the  subgrid. 

Cautions 

:  None . 

GF-38 

Question 

Enter  the  SUBGRID  INTERVAL  > 

A 

Options 

:  >  1 

w 

7-41 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  2;  GF-27,  option  3  or  4. 

Define  To  interpolate  output  boundary  conditions  from  the  original 

grid  to  points  on  the  subgrid,  the  interval  of  the  subgrid 
cells  relative  to  the  original  grid  cells  must  be  identi¬ 
fied.  That  is,  if  there  are  two  subgrid  rows  and  columns 
for  each  row  and  column  of  the  original  grid,  then  the 
subgrid  interval  is  two  (2).  Similarly,  if  there  are  three 
subgrid  rows  and  columns  for  each  row  and  column  of  the 
original  grid,  then  the  subgrid  interval  is  three  (3). 

After  the  correspondence  between  grid  points  is  identified 
(question  GF-37)  and  the  subgrid  interval  is  specified,  then 
the  Subgrid  Interpolation  File  is  automatically  prepared  for 
use  by  the  INTERP  program  (see  Part  V).  The  INTERP  program 
interpolates  the  output  boundary  condition  data  from  the 
original  grid  to  input  boundary  conditions  for  the  subgrid 
simulation. 

Cautions  :  None . 

PATH:  o  IF  NO  OUTPUT  BOUNDARY  CONDITIONS  SPECIFIED  (Option  1  or  3, 

question  GF-27),  GO  TO  GF-53. 

GF-39  Question  :  Enter  BOUNDARY  DATA  OUTPUT  INTERVAL  > 

Options  :  >  0 

Preselect:  GF-2,  option  2  or  3;  GF-27,  option  2  or  4. 

Define  ;  The  boundary  output  data  are  the  data  used  as  input  for  a 
subsequent  subgrid  simulation  (question  GF-3).  Note  that 
for  any  SHALWV  simulation,  the  wind  input  interval  and  the 
input  boundary  condition  interval  must  coincide.  This  means 
that  the  boundary  data  output  interval  for  the  original  grid 
simulation  must  be  the  same  interval  as  the  input  winds  for 
the  subgrid  simulation.  For  example,  if  the  computational 
time-step  (question  GF-13)  is  3  min  (180  sec)  for  the  cur¬ 
rent  (original)  SHALWV  simulation  and  the  wind  input  inter¬ 
val  for  the  subgrid  simulation  will  be  1  hr  (3,600  sec), 
then  the  boundary  data  output  interval  should  be  every  20 
computational  time -steps. 

Cautions  :  Note  that  the  question  does  not  ask  for  the  amount  of  time 
between  output  intervals  but  the  number  of  computational 
time -steps  between  boundary  data  output. 

GF-40  Question  :  Enter  the  NUMBER  OF  OUTPUT  LOCATIONS  for  subgrid  > 

Options  :  >  0 

Preselect:  GF-2,  option  2  or  3;  GF-27,  option  2  or  4. 

Define  :  The  number  of  locations  on  the  original  grid  where  output 

should  be  saved  for  a  subsequent  subgrid  simulation  must  be 
identified.  The  output  locations  should  include  every  grid 
point  that  is  not  designated  as  land  along  the  borders  of 
the  subgrid.  Note  that  since  the  outer  edge  of  the  subgrid 
will  be  designated  as  a  solid  boundary,  the  output  locations 
should  be  ona  row  or  column  inside  the  subgrid.  (See  Figure 


7-6.)  See  questions  GF-41,  GF-42  and  GF-43  for  details 
about  entering  the  COLUMN  and  ROW  values  for  the  locations. 

If  the  number  of  locations  is  less  than  four  (4) ,  then  you 
will  be  asked  to  input  the  COLUMN  and  ROW  values  for  each 
location. 

If  four  or  more  locations  are  specified,  you  will  be  asked 
to  enter  up  to  four  locations,  and  the  module  will  determine 
all  of  the  locations  (grid  points)  that  lie  between  the 
locations  you  enter. 

Cautions  :  None . 

PATH:  o  IF  LESS  THAN  FOUR  (4)  OUTPUT  BOUNDARY  CONDITION  LOCATIONS 

(question  GF-40) ,  GO  TO  GF-43. 

GF-41  Question  :  Enter  the  first  point  location  (COL  &  ROW)  >  COLUMN  and  ROW 
values: 

Options  :  Variable . 

Preselect:  GF-2,  option  2  or  3;  GF-27,  option  2  or  4;  GF-39,  option  4. 

Define  :  When  four  or  more  output  boundary  locations  are  used  (ques¬ 
tion  GF-40) .  You  will  be  prompted  for  the  COLUMN  and  ROW 
values  for  up  to  four  (4)  output  locations.  The  locati  n- 
you  enter  are  the  four  points  around  the  subgrid  boundary  as 
identified  in  the  example  in  Figure  7-6.  The  module  will 
determine  which  output  boundary  locations  lie  between  the 
locations  you  enter. 

Following  the  example  in  Figure  7-6,  you  will  enter  the 
values  (31,16).  Question  GF-42  then  asks  for  the  remaining 
points  in  sequence,  i.e.,  locations  (26,16),  (26,20)  and 

(28.20) .  The  module  will  then  find  all  of  the  grid  points 
that  lie  between  these  points,  or  locations  (30,16), 

(29,16),  (28,16),  (27,16),  (26,17),  (26,18),  (26,19), 

(27.20) ,  and  (28,20). 

Cautions  :  None . 

GF-42  Question  :  Enter  another  point  location  (COL  &  ROW)  > 

COLUMN  and  ROW  values: 

Options  :  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-27,  option  2  or  4;  GF-40,  option  > 

4. 

Define  :  Following  your  entry  of  the  first  output  boundary  location 
in  question  GF-41,  you  must  enter  the  next  sequential  point. 
(See  description  in  question  GF-41).  If  you  have  entered 
all  of  the  corner  points  through  previous  repeats  of  this 
question,  then  enter  a  (0,0)  to  indicate  that  no  more  points 
will  be  entered. 

Cautions  :  If  you  enter  (0,0)  when  this  question  is  first  asked,  the 
module  will  not  have  enough  points  with  which  to  determine 
output  boundary  locations.  The  module  will  assume  you  no 
longer  want  to  use  output  boundary  locations,  and  it  will 


continue  through  the  rest  of  the  General  File  Building 
session.  Any  output  boundary  condition  requests  will  be 
neglected.  That  is,  no  output  boundary  data  will  be  saved 
for  a  subgrid  simulation. 

PATH:  o  IF  MORE  THAN  FOUR  OUTPUT  BOUNDARY  CONDITION  LOCATIONS  (question 

GF-40)  AND  INPUT  BOUNDARY  CONDITIONS  SPECIFIED  (Option  3  or  4, 
question  GF-27),  GO  TO  GF-44. 

o  IF  MORE  THAN  FOUR  OUTPUT  BOUNDARY  CONDITION  LOCATIONS  (question 

GF-40)  AND  NO  INPUT  BOUNDARY  CONDITIONS  ARE  SPECIFIED  (Option  1 
or  2,  question  GF-27),  GO  TO  GF-53. 

GF-43  Question  :  Enter  the  SUBGRID  OUTPUT  LOCATIONS  > 

COLUMN  and  ROV  for  point  ##: 

Options  :  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-27,  option  2  or  4;  GF-40,  option  4. 

Define  :  The  column  and  row  values  for  the  number  of  locations  speci¬ 
fied  in  question  GF-40  must  be  entered.  Enter  one  pair  of 
values  (COL,  ROW)  per  line.  The  output  locations  should 
correspond  to  locations  along  the  border  of  the  subgrid  as 
shown  in  Figure  7-6. 

Cautions  :  None . 

PATH:  o  IF  NO  INPUT  BOUNDARY  CONDITIONS  (Option  3  or  4,  question 

GF-27),  GO  TO  GF-53. 

GF-44  Question  :  Enter  the  NUMBER  OF  INPUT  BOUNDARY  LOCATIONS  > 

Options  :  >  0 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4. 

Define  :  If  you  want  to  start  your  simulation  with  initial  wave 

conditions,  input  boundary  condition  information  is  neces¬ 
sary.  (See  question  GF-27,  Input  Boundary  Conditions.)  You 
may  provide  the  input  boundary  conditions  at  locations  which 
you  specify  on  the  border  of  the  computational  grid.  If  you 
indicate  that  fewer  than  four  locations  will  be  used  to 
input  boundary  conditions,  then  you  will  be  prompted  for  the 
COLUMN  and  ROW  values  for  those  locations. 

If  four  or  more  locations  are  specified,  you  will  be  asked 
to  enter  up  to  four  locations,  and  the  module  will  determine 
all  of  the  locations  (grid  points)  that  lie  between  the 
locations  you  enter. 

Cautions  :  Note  that  this  question  is  asked  only  for  non-subgrid  simu¬ 
lations.  When  subgrids  are  used,  input  boundary  conditions 
can  come  only  from  previous  SHALWV  simulation  where  informa¬ 
tion  was  saved  to  act  as  input  boundary  location  for  a 
subsequent  subgrid  run#. 

PATH:  o  IF  LESS  THAN  FOUR  INPUT  BOUNDARY  CONDITION  LOCATIONS  (question 

GF-44),  GO  TO  GF-47. 
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GF-45  Question  :  Enter  the  first  point  location  (COL  &  ROW)  >  COLUMN  and  ROW 
values : 


Options  : 
Preselect : 


Define 


Cautions  : 


Variable . 

GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  cr  4; 
GF-44,  option  4. 

When  four  or  more  input  boundary  locations  are  to  be  used 
(question  GF-44),  you  will  be  prompted  for  the  COLUMN  and 
ROW  values  for  up  to  four  (4)  input  locations.  The  loca¬ 
tions  entered  should  be  sequential,  as  shown  in  Figure  7- 
12 .  The  module  will  determine  which  input  boundary  loca¬ 
tions  lie  between  the  locations  you  enter.  Note  that  the 
locations  must  be  one  row  or  column  inside  the  grid  because 
the  outer  boundary  of  the  grid  is  assumed  a  solid  boundary 
(land  point  in  the  Land/Water  matrix). 

Following  the  example  in  Figure  7-12,  enter  the  value 
(10,1).  Question  GF-46  then  asks  for  the  remaining  points 
in  sequence,  i.e.,  locations  (10,4),  (10,6)  and  (10,8).  The 
module  then  finds  all  of  the  grid  points  that  lie  between 
these  points,  or  locations  (10,2),  (10,3),  (10,5)  and 
(10,7). 

Land  points  specified  as  input  boundary  locations  will 
provide  no  input  to  the  model . 


SIDE  2  WAVE  DIRECTION 


Figure  7-12.  Example  of  input  boundary  condition  location  specifications 
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GF-46  Question  :  Enter  another  point  location  (COL  &  ROW)  >  COLUMN  and  ROW 
values : 

Options  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4; 
GF-44,  option  >  4. 

Define  :  Following  your  entry  of  the  first  input  boundary  location  in 
question  GF-45,  you  must  enter  the  next  sequential  point. 
(See  description  in  question  GF-45.)  When  you  have  entered 
all  of  the  points  using  this  question,  then  enter  a  (0,0)  to 
indicate  that  no  more  points  will  be  entered. 

Cautions  :  If  you  enter  (0,0)  when  this  question  is  first  asked,  the 
module  will  not  have  enough  points  with  which  to  determine 
input  boundary  locations .  The  module  will  assume  you  no 
longer  want  to  use  input  boundary  locations ,  and  it  will 
continue  through  the  rest  of  the  General  File  Building 
session,  neglecting  any  input  boundary  condition  requests. 
The  lack  of  input  boundary  conditions  means  that  the  simula¬ 
tion  will  begin  without  any  initial  wave  conditions  and  no 
wave  conditions  will  be  propagated  into  the  region  being 
modeled  from  outside  that  region  during  the  simulation. 

Land  points  specified  as  input  boundary  locations  will 
provide  no  input  to  the  model. 

PATH:  o  IF  FOUR  OR  MORE  INPUT  BOUNDARY  LOCATIONS  (question  GF-44),  GO 

TO  GF-48 . 

GF-47  Question  :  Enter  INPUT  BOUNDARY  LOCATIONS  > 

COLUMN  and  ROW  for  point  ##: 

Options  :  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4; 
GF-44,  option  <  4. 

Define  :  Enter  the  column  and  row  values  for  the  number  of  locations 
specified  in  question  GF-44.  Enter  one  pair  of  values  (COL, 
ROW)  per  line.  The  input  boundary  locations  should  corres¬ 
pond  to  locations  on  the  border  of  the  grid  as  shown  in 
Figure  7-12. 

Cautions  :  Land  points  specified  as  input  boundary  locations  will 
provide  no  input  to  the  model. 

GF-48  Question  :  Enter  the  PEAK  SPECTRAL  FREQUENCY  > 

Options  :  >  0 

Preselect:  GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4 

Define  (See  the  description  of  initial  conditions  in  question  GF- 

27.)  The  peak  spectral  frequency  is  based  on  the  input 
boundary  conditions.  For  example,  if  the  wave  used  as  a 
boundary  condition  has  a  10-sec  period,  the  peak  spectral 
frequency  would  be  the  inverse  of  the  period,  or  0.1  Hz.  If 
no  initial  conditions  are  desired,  set  the  value  to  some 
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Cautions 
GF-49  Question 
Options 
Preselect 
Define 

Cautions 
GF-50  Question 
Options 
Preselect 
Define 

Cautions 
GF-51  Question 
Options 
Preselect 
Define 

Cautions 
GF*52  Question 
Options 
Preselect 
Define 

Cautions 
GF-53  Question 
Options 


Preselect : 
Define  : 


Cautions  : 


thing  much  larger  than  the  peak  frequency  of  the  input 
boundary  condition  spectrum. 

None . 

Enter  the  Phillips'  Equilibrium  Constant  > 

0  <  VALUE  iS  0.1 

GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4; 

See  description  in  GF-27.  Note  that  selection  of  a  may  be 
used  to  control  Hoo  ■ 

None . 

Enter  the  Spectral  Peakedness  Factor  > 

0  <  VALUE  4 

GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4 

See  question  GF-27  for  description.  A  recommended  value  is 
3.3. 

None . 

Enter  the  SPECTRAL  PARAMETER,  SIGMA  A  > 

0  <  VALUE  <0.2 

GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4 

See  question  GS-27  for  description.  Recommended  value  is 
0.07. 

None. 

Enter  the  SPECTRAL  PARAMETER,  SIGMA  B  > 

0  <  VALUE  <0.2 

GF-2,  option  2  or  3;  GF-3,  option  1;  GF-27,  option  3  or  4 

See  question  GF-27  for  description.  Recommended  value  is 
0.09. 

None . 

Enter  the  DIFFRACTION  OPTION  > 

1  -  No  diffraction 

2  -  Diffraction;  data  read  from  file 

3  -  Diffraction;  data  entered  interactively 
GF-2,  Option  2  or  3; 

See  Part  II  for  a  description  of  the  diffraction  routines 
used  in  SHALWV.  Indicate  here  whether  diffraction  will  be 
used  and,  if  so,  how  the  diffraction  information  will  be 
entered. 

None . 
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PATH:  o 


IF  MO  DIFFRACTION  (Option  1,  question  OF-53),  00  TO  GF-58. 

o  IF  DIFFRACTION  DATA  ENTERED  INTERACTIVELY  (Option  3,  question 

GF-53) ,  CO  TO  GF-55 . 

GF-54  Question  :  Enter  the  DIFFRACTION  DATA  FILE  name  > 

Options  :  Variable 

Preselect:  GF-2,  option  2  or  3;  GF-53,  option  2 

Define  You  must  identify  the  name  of  the  file  containing  the  dif¬ 

fraction  data  in  order  for  SHALWV  to  use  it.  Once  an  ac¬ 
ceptable  file  name  is  given,  the  module  will  read  the  dif¬ 
fraction  file.  If  the  diffraction  data  are  read  successful¬ 
ly,  a  message  will  be  issued  indicating  such.  If  an  error 
is  encountered,  a  message  will  be  issued  indicating  such  and 
advising  you  that  the  diffraction  option  will  be  omitted 
from  the  simulation.  If  diffraction  is  still  needed,  the 
General  File  Building  session  must  be  terminated  and  the 
diffraction  data  file  corrected.  Then,  the  General  File 
Building  session  must  be  rerun  to  include  the  diffraction 
option. 

Cautions  :  If  no  satisfactory  file  name  is  entered,  then  the  diffrac¬ 
tion  option  will  be  omitted  from  the  simulation.  The  Gener¬ 
al  File  Building  session  will  proceed.  The  file  name  must 
conform  to  the  file  naming  conventions  of  the  UNIX  operating 
system. 

PATH:  o  IF  DIFFRACTION  DATA  ENTERED  BY  A  FILE  (Option  2,  question 

GF-53).  GO  TO  58. 

GF-55  Question  :  Enter  the  NUMBER  OF  DIFFRACTED  LOCATIONS  > 

Options  :  Variable . 

Preselect:  GF-2,  option  2  or  3;  GF-53,  option  3 

Define  :  A  diffraction  location  is  defined  as  the  end  of  a  breakwater 
(or  island,  etc.)  around  which  diffraction  will  occur.  The 
free  field  energy  (unaffected  by  diffraction)  used  to  calcu¬ 
late  diffraction  for  the  breakwater  is  the  grid  point  oppo¬ 
site  the  end  of  the  breakwater  along  the  axis  of  the  break¬ 
water  . 

Cautions  :  You  will  be  prompted  for  the  column  and  row  values  for  each 
diffracted  location.  If  a  zero  (0)  is  entered,  the  module 
will  assume  that  the  diffraction  option  is  no  longer  de¬ 
sired,  and  therefore,  diffraction  will  be  omitted  from  the 
simulation. 

GF-56  Question  :  Enter  the  Locations  > 

COLUMN  and  ROW  for  point  ##: 

Options  :  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-53,  option  3;  GF-55,  option  >  0 

Define  :  The  column  and  row  values  (I,J  locations)  must  be  identified 
for  each  of  diffracted  locations  indicated  in  question  GF- 
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55.  See  Figure  5  for  grid  point  orientation  and  numbering 
convention. 

Cautions  :  None. 

GF-57  Question  :  Enter  POSITION  OPTION  FOR  THE  DIFFRACTING  STRUCTURE  >  Posi¬ 
tion  number  at  point  ##  (col  -  ##,  rov  -  ##) : 

Options  :  1-8 

Preselect:  GF-2,  option  2  or  3;  GF-53,  option  3;  GF-55,  option  >  0 

Define  :  The  position  of  the  diffracting  structure  pertains  to  the 
value  of  K.  See  question  GF-55. 

Cautions  :  None. 

GF-58  Question  :  Enter  SHELTERING  OPTION  > 

Options  :  1  -  No  Sheltering 

2  -  Sheltering;  data  read  from  file 

3  -  Sheltering;  data  entered  interactively 

Preselect:  GF-2,  Option  2  or  3; 

Define  :  (See  Part  II).  Sheltering  allows  you  to  manually  reduce 

wave  heights  at  desired  grid  locations.  This  is  particular¬ 
ly  useful  in  the  lee  of  a  solid  structure  such  as  an  island 
or  a  breakwater  where  computed  refraction  and  diffraction 
effects  are  not  sufficient.  If  you  elect  to  use  sheltering, 
the  required  sheltering  data  may  be  entered  from  a  file  or 
interactively. 

Cautions  :  If  you  elect  the  diffraction  option  in  question  GF-53,  then 
sheltering  must  also  be  selected. 

PATH:  o  IF  NO  SHELTERING  (Option  1,  question  GF-58),  BEGIN  SUMMARY 

REVIEW. 

o  IF  SHELTERING  DATA  ENTERED  INTERACTIVELY  (Option  3,  question 

GF-58),  GO  TO  GF-60. 

GF-59  Question  :  Enter  the  SHELTERING  DATA  FILE  name  > 

Options  :  Variable. 

Preselect:  GF-2,  option  2  or  3;  GF-58,  option  2 

Define  :  You  must  identify  the  name  of  the  file  containing  the  shel¬ 
tering  data  in  order  for  SHALWV  to  use  it.  Once  a  suitable 
file  name  is  given,  the  module  will  read  the  sheltering  data 
file.  If  the  sheltering  data  are  read  successfully,  a  mes¬ 
sage  will  be  issued  indicating  such.  If  an  error  is  encoun¬ 
tered,  a  message  will  be  issued  indicating  such  and  advising 
you  that  the  sheltering  option  as  well  as  the  diffraction 
option  will  be  omitted  from  the  simulation.  If  sheltering 
and  diffraction  are  still  needed,  the  General  File  Building 
session  must  be  terminated  and  the  sheltering  data  file 
corrected.  Then,  the  General  File  Building  session  must  be 
rerun  to  include  the  sheltering  option. 
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The  file  name  oust  conform  the  file  naming  conventions  of 
the  UNIX  operating  system. 

Enter  the  NUMBER  07  SHELTERED  LOCATIONS  > 

>  0 

GF-2,  option  2  or  3;  GF-58,  option  3 

You  must  indicate  how  many  locations  on  the  computational 
grid  require  application  of  the  sheltering  option. 

If  a  zero  (0)  value  is  entered,  the  module  will  assume  that 
sheltering  is  no  longer  desired  and  will  omit  it  from  the 
simulation.  However,  the  diffraction  option  will  also  be 
omitted. 

Enter  the  Sheltered  Locations  > 

COLUMN  and  ROW  for  point  ##: 

Variable 

GF-2.  option  2  or  3;  GF-58,  option  3 

The  column  and  row  values  must  be  entered  for  the  number  of 
sheltered  points  indicated  in  question  GF-60. 

The  locations  must  be  over  water.  The  module  will  not  check 
to  be  sure  locations  are  over  water. 

The  grid  points  that  you  specify  as  sheltered  will  be 
displayed  in  a  tabular  format  and  you  will  then  be 
given  an  opportunity  to  specify  the  "percent  shel¬ 
tered"  for  energy  in  each  direction  band,  for  each  of 
the  specified  grid  points. 

37.  At  this  point  you  will  be  presented  with  a  summary  review  of  the 

data  that  you  entered  during  the  General  File  Building  session.  You  have  the 
option  to  skip  the  summary  if  you  so  desire.  You  may  want  to  look  through  the 
summary  the  first  few  times  you  run  the  General  File  Building  session  to 
acquaint  yourself  with  the  contents  of  it.  However,  the  review  can  be 

lengthy.  So  once  you  have  gained  confidence  in  using  the  General  File 
Building  routine,  you  may  prefer  to  skip  the  summary  review. 

Wind  File  Building  routine 

38.  There  are  three  modes  in  which  winds  may  be  entered  in  the  SHALWV 
simulation.  The  first  mode  specifies  winds  as  constant  for  the  entire 
simulation  period  and  area.  For  this  mode,  only  one  wind  speed  and  direction 
are  required.  The  second  mode  specifies  temporally  varying,  spatially 
constant  winds.  For  this  mode,  a  wind  speed  and  direction  are  entered  for 
each  wind  input  interval.  The  third  mode  specifies  temporally  and  spatially 
varying  wind  speeds  and  directions.  For  this  mode,  wind  speed  and  direction 
values  are  entered  for  each  computational  grid  point  and  for  each  wind  input 


Cautions  : 

GF-60  Question  : 
Options 
Preselect: 
Define 

Cautions  : 

GF-61  Question  : 

Options 

Preselect: 

Define 

Cautions  : 
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interval.  The  Wind  File  Building  routine  will  create  and  format  a  Wind  Data 
File  for  any  of  the  above  modes. 

39.  Wind  input  data  should  be  equivalent  over  water,  10-m  elevation, 
neuturally  stable  winds.  Wind  data  obtained  from  meteorological  stations  may 
not  fit  these  criteria.  However,  most  data  can  be  corrected  to  be  approxi¬ 
mately  "equivalent"  to  the  above  criteria.  Methods  for  correcting  wind  data 
can  be  found  in  the  Shore  Protection  Manual  (SPM  1984) .  Note  that  winds  are 
required  for  any  SHALWV  simulation.  If  winds  are  not  desired,  values  of 

1  knot  should  be  used  for  wind  speed. 

40.  The  wind  data  for  the  constant  wind  input  mode  can  be  entered 
interactively  only  during  the  Wind  File  Building  routine.  The  wind  data  for 
temporally  varying  wind  input  mode  may  be  entered  either  interactively  during 
the  Wind  File  Building  session  or  through  a  data  file  that  contains  the  wind 
information.  The  wind  data  for  the  temporally  and  spatially  varying  wind 
input  mode  must  be  entered  via  a  file.  It  is  assumed  that  the  volume  of  data 
for  this  mode  is  too  great  to  be  entered  interactively.  Descriptions  of  the 
required  formats  for  files  containing  the  temporally  varying  only  or  the 
temporally  and  spatially  varying  wind  data  are  given  in  Part  V. 

41.  It  is  recommended  that  the  General  Input  File  Building  routine  be 
run  prior  to  running  the  Wind  Input  File  Building  routine.  The  selection  of 
the  wind  input  mode  and  other  options  required  for  wind  input  is  made  during 
the  General  File  Building  session.  The  Wind  Input  File  Building  routine  reads 
the  General  Input  File  to  obtain  that  information  and  then  prompts  the  user 
for  the  proper  wind  information.  If  the  Wind  File  Building  Routine  is  run 
before  the  General  File  Building  Routine,  then  the  user  will  be  asked  by  the 
Wind  File  Building  routine  to  specify  the  wind  input  mode  and  other  options. 
The  user  must  then  be  care  thnr  the  same  specifications  are  made  when  the 
General  File  Building  routine  is  used.  Note  that  if  the  specifications  are 
not  identical  between  the  two  file  building  routines,  an  error  will  result 
when  SHALWV  is  run.  The  Wind  Input  File  Building  routine  is  the  only  routine 
in  the  SHALWV  branch  of  the  Spectral  Wave  Modeling  Module  that  can  be  executed 
without  previously  running  the  General  File  Building  routine. 

Data  descriptions  for  Wind  Input  File 

42.  Descriptions  of  the  data  prompted  for  by  the  module  during  the  Wind 
Input  File  session  are  provided  below.  The  format  used  to  describe  the  data 
is  the  same  as  that  discussed  in  Part  IV. 


WF-1  Question  :  General  File  Building  has  been  runt  (yes/no)  > 

Options  y  (or  Y)  -  General  File  Building  routine  has  been  run 
n  (or  N)  -  General  File  Building  routine  was  not  run 

Preselect:  None. 

Define  :  See  introductory  description  to  this  section  of  the  User's 
Guide . 

Cautions  :  If  you  answer  yes,  you  must  be  certain  that  the  General 
Input  File  exists.  If  it  does  not  exist,  an  error  will 
occur,  and  the  Wind  File  Building  session  will  end.  If  you 
answer  no,  you  must  be  certain  that  the  values  you  provide 
for  questions  WF-2,  WF-3,  WF-4,  WF-14,  and  WF-15  are  respec¬ 
tively  identical  to  your  answers  to  questions  GF-28,  GF-33, 
GF-34,  GF-4  and  GF-5  in  Part  IV. 

PATH:  o  IF  GENERAL  FILE  BUILDING  ROUTINE  HAS  BEEN  RUN  (Option  'yes', 
question  WF-1),  GO  TO  GF-5. 

WF-2  Question  :  Enter  Wind  Field  Type  > 

Options  :  1  -  Constant  winds 

2  -  Constant  over  space,  variable  over  time 

3  -  Variable  over  space  and  time 

Preselect:  WF-1,  option  "no" 

Define  :  The  wind  input  mode  must  be  defined.  For  simulations  where 
wind  speed  and  direction  are  considered  constant  over  space 
and  time,  it  is  convenient  to  use  option  1  to  minimize  the 
amount  of  data  entered.  You  will  be  prompted  for  one  pair 
of  wind  speed  and  direction  values. 

For  simulations  where  winds  vary  over  time  but  not  over 
space  (e.g.,  a  small  body  of  water  where  winds  are  virtually 
the  same  everywhere),  then  option  2  should  be  selected.  The 
data  may  be  entered  via  a  data  file  or  interactively.  If 
the  winds  vary  in  time  and  space,  then  option  3  must  be 
selected.  The  volume  of  data  for  winds  that  vary  over  time 
and  space  is  usually  so  large  that  it  can  be  entered  only 
via  a  data  file.  (The  formats  for  the  wind  data  files  can 
be  found  in  Part  V.) 

Cautions  :  The  mode  selected  must  be  consistent  with  the  mode  selected 
for  question  GF-28  in  Part  IV.  The  wind  data  must  be  given 
as  the  equivalent,  overwater  10-m  elevation,  neutrally 
stable  winds. 

WF-3  Question  :  Enter  No.  hours  between  wind  inputs  > 

Options  :  Must  be  between  1  and  24  (inclusive) . 

Preselect:  WF-1,  option  "no" 

Define  :  The  wind  data  must  be  input  at  regular  intervals  during  the 
simulation  (e.g.  every  hour  (1),  every  2  hours  (2),  etc.). 
The  interval  between  wind  inputs,  together  with  the  answer 
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Cautions  : 

WF-4  Question  : 
Options  : 
Preselect: 
Define  : 


Cautions  : 

WF-5  Question  : 
Options  : 


Preselect: 
Define  : 

Cautions  : 
WF-6  Question  : 
Options  : 

Preselect: 
Define  : 


Cautions  : 


to  WF-4  (number  of  wind  input  intervals)  define  the  length 
of  the  simulation.  For  example,  if  the  interval  is  every 
2  hr  and  there  are  12  wind  input  intervals,  then  the  simu¬ 
lation  is  for  a  24-hr  period  (2  hr  times  12). 

The  value  selected  must  be  consistent  with  the  value  select¬ 
ed  for  question  GF-33  in  Part  IV. 

Enter  the  total  number  of  wind  inputs  > 

1  <  VALUE  <  100 

WF-1,  option  "no" 

The  total  number  of  wind  inputs  and  the  number  of  wind  input 
intervals  implicitly  define  the  length  of  the  simulation. 
That  is,  based  on  the  size  of  the  time  interval  between  wind 
inputs  (WF-3)  and  the  number  of  intervals,  the  total  length 
of  the  simulation  is  defined.  For  example,  if  the  time 
interval  is  2  hr  and  the  number  of  intervals  is  12 ,  then  the 
simulation  is  for  24  hr  (2  hr  times  12). 

The  value  selected  must  be  consistent  with  the  value  select¬ 
ed  for  question  GF-34  in  Part  IV. 

Enter  Wind  Speed  Convention  > 

1  -  Meters  per  second 

2  -  Miles  per  hour 

3  -  Knots 
None. 

The  units  for  the  wind  speed  must  be  defined.  The  units  are 
converted  automatically  to  knots  for  use  by  SHALWV. 

None . 

Enter  direction  convention  for  winds  > 

1  -  Cartesian,  "TOWARD  which  winds  blow." 

2  -  Meteorological  (°  azimuth),  "FROM  which  winds  blow." 

None . 

The  convention  used  to  define  the  wind  direction  must  be 
provided.  The  convention  will  be  converted  to  Cartesian 
automatically  for  use  by  SHALWV.  See  Figure  7-13  for  an 
illustration  of  the  different  conventions. 

None . 


PATH:  o  IF  WINDS  ARE  SPATIALLY  CONSTANT  AND  TEMPORALLY  VARYING  (Option  2, 
question  WF-2),  GO  TO  WF-9. 

o  IF  GENERAL  FILE  BUILDING  ROUTINE  WAS  NOT  RUN  (Option  'no',  ques¬ 
tion  WF-1)  AND  WINDS  ARE  SPATIALLY  AND  TEMPORALLY  VARYING  (Option 
3,  question  WF-2),  GO  TO  WF-14. 

o  IF  GENERAL  FILE  BUILDING  ROUTINE  WAS  RUN  (Option  'yes’,  question 
WF-1)  AND  WINDS  ARE  SPATIALLY  AND  TEMPORALLY  VARYING  (Option  3, 
question  WF-2),  GO  TO  WF-16. 
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WF-7  Question 
Options 
Preselect 
Define 


Cautions 


WF-8  Question 
Options 
Preselect 
Define 


Cautions 

PATH:  o  END 
WF-9  Question 
Options 

Preselect 

Define 


Cautions 


PATH:  o  IF 
GO 

WF-10  Question 
Options 
Preselect 


Enter  the  wind  speed  > 

0  <  VALUE  <  100 
WF-2,  option  1 

The  wind  speed  (assumed  constant  over  space  and  time)  must 
be  entered  in  the  units  specified  in  question  WF-5.  Note 
that  SHALWV  rounds  the  numbers  to  integer  values ,  so  be  sure 
that  the  value  is  sufficient  so  as  not  to  round  to  zero. 

The  wind  data  must  be  given  as  the  equivalent,  10-m  eleva¬ 
tion,  neutrally  stable  winds.  Although  SHALWV  is  designed 
to  simulate  hurricane -generated  wave  conditions,  there  has 
been  an  upper  limit  set  on  the  maximum  wind  speed.  If  you 
require  greater  wind  speeds  than  allowed,  contact  CERC  for 
support. 

Enter  the  Wind  Direction  > 

:  0  <  VALUE  <  360  degrees 

:  WF-2,  option  1 

The  wind  direction  (assumed  constant  over  space  and  time) 
must  be  entered  using  the  direction  convention  specified  in 
question  WF-6. 

:  The  winds  must  be  given  as  the  10-m  elevation,  neutrally 
stable  overwater  values. 

WIND  FILE  BUILDING  ROUTINE 

Input  Wind  Information  from  a  File?  (yes/no)  > 

y  (or  Y)  -  Wind  data  will  be  entered  from  a  file 

n  (or  N)  -  Wind  data  will  be  entered  interactively 

:  WF-2,  option  2 

:  You  may  enter  the  wind  speed  and  direction  for  every  wind 
input  interval  (see  question  WF-4  and  GF-34  in  Part  IV) 
interactively  or  by  a  data  file.  If  the  data  will  be  en¬ 
tered  by  a  file,  the  file  must  currently  exist.  The  data 
format  for  the  file  is  described  in  Part  V. 

:  If  you  answer  yes  and  the  file  does  not  exist  or  there  is  an 

error  in  the  data  format  within  the  file,  an  error  message 
will  be  issued  and  the  Wind  File  Building  session  will  end. 
No  information  will  be  saved,  and  you  will  be  required  to 
correct  the  file  format  before  rerunning  Wind  Input  File 
Building  routine. 

WIND  DATA  ENTERED  INTERACTIVELY  (Option  'no',  question  WF-9), 

TO  WF-12 . 

Enter  the  Input  Wind  File  Name  > 

Variable 

WF-2,  option  2;  WF-9,  option  "yes" 
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Define  The  name  of  the  file  containing  the  wind  speeds  and  direc¬ 

tions  must  be  identified. 

Cautions  :  The  file  name  must  conform  to  the  file  naming  conventions  of 
the  UNIX  operating  system.  If  the  file  cannot  be  found,  the 
Wind  File  Building  session  will  end.  No  information  will  be 
saved.  You  will  be  required  to  correct  the  file  and  rerun 
the  Wind  Input  File  Building  routine. 

WF-11  Question  :  Does  File  Contain  Dates?  (yes  or  no)  > 

Options  :  y  (or  Y)  -  the  file  does  contain  date  headers 

n  (or  N)  -  the  file  does  not  contain  date  headers 

Preselect:  WF-2,  option  2;  WF-9,  option  "yes" 

Define  :  You  have  the  option  to  include  date  headers  in  the  wind  data 
file  that  is  read  by  the  module.  (See  data  format  descrip¬ 
tion  in  Part  V.)  You  must  specify  whether  date  headers  have 
been  included  in  your  wind  data  file. 

Cautions  :  If  you  provide  the  incorrect  specification  of  the  date 

headers,  an  error  will  occur  when  the  module  tries  to  read 
the  wind  data.  A  message  will  be  issued  indicating  such, 
and  the  Wind  File  Building  session  will  be  terminated.  No 
information  will  be  saved.  You  must  correct  the  file  format 
before  the  Wind  Input  File  Building  routine  can  be  rerun. 

PATH:  o  IF  WIND  FILE  CONTAINS  DATES  (Option  'yes',  question  WF-11),  END 
WIND  FILE  BUILDING  ROUTINE. 

WF-12  Question  :  Enter  the  start  date  for  wind  input  > 

Options  :  0  <  VALUE  <  99999999 

Preselect:  WF-2,  option  2;  WF-9,  option  "no" 

Define  :  The  date  corresponding  to  the  first  set  of  wind  speed  and 
direction  values  must  be  entered.  The  format  used  is 
'yymmddhh'  where  yy  is  the  year,  mm  is  the  month,  dd  is  the 
day,  and  hh  is  the  hour  (military  time,  e.g.,  00  -  midnight 
and  23  -  11  pm) .  The  dates  that  correspond  to  the  other 
data  values  will  be  automatically  generated.  The  dates  are 
incremented  by  the  interval  identified  in  question  WF-3  or 
question  GF-33  in  Part  IV. 

Cautions  :  None. 

WF-13  Question  :  Wind  Speed  and  Direction: 

Options  :  0  <  Wind  Speed  <  100 

0  <  Wind  Direction  <  360 

Preselect:  WF-2,  option  2;  WF-9,  option  "no" 

Define  :  The  pairs  of  wind  speed  and  direction  data  must  be  entered 

sequentially  for  each  wind  input  interval  (question  WF-4  and 
question  GF-34  in  Part  IV).  The  values  should  be  separated 
by  a  comma  ( , )  or  a  space  (  ) . 

Cautions  :  None. 
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PATH:  o  END  WIND  FILS  BUILDING  ROUTINE. 

WF-14  Question  :  Enter  Number  of  Columns  in  Grid  > 

Options  5  to  100 

Preselect:  WF-1,  option  "no";  WF-2,  option  3 

Define  :  -See  description  for  question  GF-4  in  Part  IV. 

Cautions  :  The  selected  value  must  be  consistent  with  the  value  entered 
for  question  GF-4  in  Part  IV. 

WF-15  Question  :  Enter  the  Number  of  Rows  in  the  Grid  > 

Options  :  5  to  100 

Preselect:  WF-1,  option  "no";  WF-2,  option  3 

Define  :  See  description  for  question  GF-5  in  Part  IV. 

Cautions  :  The  value  selected  must  be  consistent  with  the  value  entered 
for  question  GF-5  in  Part  IV. 

WF-16  Question  :  Select  Coordinate  System  > 

Options  :  1  -  Cartesian 

2  -  User-defined  coordinate  system 
Preselect:  WF-2,  option  3 

Define  :  You  must  define  the  coordinate  system  that  you  are  using  for 
your  computational  grid.  Examples  of  each  coordinate  system 
are  shown  in  Figure  7-13.  Both  computational  grids  have  the 
same  number  of  grid  points;  they  are  simply  numbered  differ¬ 
ently.  The  Cartesian  coordinate  system  is  used  by  SHALWV. 

If  you  are  using  a  user-defined  coordinate  system,  then  the 
information  you  enter  will  be  transformed  to  a  Cartesian 
coordinate  system  by  the  module. 

The  user-defined  coordinate  system  uses  distances  to  identi¬ 
fy  each  grid  point.  This  system  is  useful  when  interpola¬ 
tion  of  meteorological  data  from  buoys  is  to  be  performed  to 
acquire  wind  information  at  all  grid  locations.  That  is, 
the  exact  location  of  the  buoys  based  on  the  user-defined 
grid  may  be  used,  rather  than  the  location  of  the  nearest 
Cartesian  grid  point.  From  that  exact  location,  wind  infor¬ 
mation  can  be  interpolated  to  the  grid  points  on  a  Cartesian 
grid  which  will  be  used  by  SHALWV. 

If  you  select  the  user-defined  coordinate  system,  then  you 
will  be  asked  for  the  coordinates  of  the  corners  of  your 
grid  to  facilitate  transformation  of  your  grid  to  a  Carte¬ 
sian  system. 

Cautions  :  None . 

PATH:  o  IF  CARTESIAN  COORDINATE  SYSTEM  BEING  USED  (Option  1,  question  WF- 
16)  ,  GO  TO  WF-25 . 

WF-17  Question  :  Enter  X  coordinate  of  the  lower  left  comer  of  the  grid  > 
Options  :  £  0 
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Figure  7-13.  Grid  coordinate  conventions  for  entry  of  wind  information. 
Preselect:  WF-2,  option  3;  WF-16,  option  2 

Define  :  The  x-coordinate  (in  the  user-defined  system)  for  the  lower 
left-hand  corner  of  your  computational  grid  must  be  entered. 
See  Figure  7-13  for  an  example. 

Cautions  :  None. 

WF-18  Question  :  Enter  Y  coordinate  of  the  lover  left  corner  of  the  grid  > 
Options  :  >  0 

Preselect:  WF-2,  option  3;  WF-16,  option  2 

Define  :  The  y-coordinate  (in  the  user-defined  system)  for  the  lower 
left-hand  corner  of  your  computational  grid  must  be  entered. 
See  Figure  7-13  for  an  example. 

Cautions  :  None. 

WF-19  Question  :  Enter  X  coordinate  of  the  upper  right  comer  of  the  grid  > 

>  0 

WF-2,  option  3;  WF-16,  option  2 


Options 

Preselect 


Define  The  x-coordinate  (In  Che  user-defined  system)  for  the  upper 

right-hand  corner  of  your  computational  grid  must  be  en¬ 
tered.  See  Figure  7-13  for  an  example. 

Cautions  :  None . 

WF-20  Question  :  Enter  Y  coordinate  of  the  upper  right  corner  of  the  grid  > 

Options  >  0 

Preselect:  WF-2,  option  3;  WF-16,  option  2 

Define  :  The  y-coordinate  (in  the  user-defined  system)  for  the  upper 
right-hand  corner  of  your  computational  grid  must  be  en¬ 
tered.  See  Figure  7-13  for  an  example. 

Cautions  :  None . 

PATH:  o  GO  TO  WF-25.  (Questions  WF-21  through  VF-24  are  not  currently  in 
use . ) 

WF-21  Question  :  Enter  X  coordinate  of  the  upper  left  comer  of  the  grid  > 

Options  :  >  0 

Preselect:  WF-2,  option  3;  WF-16,  option  2 

Define  :  The  x-coordinate  (in  the  user-defined  system)  of  the  upper 
right-hand  corner  of  your  computational  grid  must  be  en¬ 
tered.  See  Figure  7-13  for  an  example. 

Based  on  the  corner  coordinates  entered  in  questions  WF-17 
through  WF-20,  the  module  can  determine  the  orientation  of 
the  grid. 

Cautions  :  None. 

WF-22  Question  :  Enter  Y  coordinate  of  the  upper  left  comer  of  the  grid  > 

Options  :  >0 

Preselect:  WF-2,  option  3;  WF-16,  option  2. 

Define  :  This  question  is  asked  only  if  your  grid  is  rotated  from  a 
true  NORTH-SOUTH,  EAST-WEST  orientation.  The  y-coordinate 
(in  the  user-defined  system)  for  the  upper  left-hand  corner 
of  your  computational  grid  must  be  entered.  See  Figure  7-13 
for  an  example. 

Cautions  :  None. 

WF-23  Question  :  Enter  X  coordinate  of  the  lover  right  comer  of  the  grid  > 

Options  :  >  0 

Preselect:  WF-2,  option  3;  WF-16,  option  2. 

Define  :  This  question  is  asked  only  if  your  grid  is  rotated  from  a 
true  NORTH-SOUTH,  EAST-WEST  orientation.  The  x-coordinate 
(in  the  user -defined  system)  for  the  lower  right-hand  corner 
of  your  computational  grid  must  be  entered.  See  Figure  7-13 
for  an  example. 

Cautions  :  None. 
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WF-24  Question 
Options 
Preselect 
Define 


Cautions 
WF-25  Question 
Options 
Preselect 
Define 


Cautions  : 


WF-26  Question  : 
Options  : 

Preselect: 
Define  : 


Cautions  : 


Enter  Y  coordinate  of  the  lover  right  corner  of  the  grid  > 

£  0 

WF-2,  option  3;  WF-16,  option  2. 

This  question  is  asked  only  if  your  grid  is  rotated  from  a 
true  NORTH-SOUTH,  EAST-WEST  orientation.  The  y-coordinate 
(in  the  user-defined  system)  for  the  lower  right-hand  corner 
of  your  computational  grid  must  be  entered.  See  Figure  7-13 
for  an  example. 

None . 

Enter  tht  Input  Wind  File  Name  > 

Variable 
WF-2,  option  3. 

The  module  assumes  that  the  wind  information  will  be  input 
from  a  file  because  of  the  volume  of  data  required  for  a 
spatially  and  temporally  varying  wind  field  is  extensive. 

The  file  name  must  conform  to  the  file  naming  conventions  of 
the  UNIX  operating  system.  If  the  file  name  is  incorrect, 
the  Wind  File  Building  session  will  end.  No  information 
will  be  saved.  The  Wind  Input  File  Building  routine  must  be 
rerun. 

Enter  Data  Format  Option  > 

1  -  data  is  in  SHALWV  format 

2  -  data  is  in  Meteorological  Station  format 
WF-2,  option  3. 

There  are  two  types  of  wind  data  file  formats  that  are 
defined  in  Part  V.  If  the  data  are  in  an  accepted  format 
for  SHALWV,  then  the  file  will  be  read  to  check  the  format 
for  errors.  If  the  data  are  in  Meteorological  Station  for¬ 
mat,  the  data  will  be  read  for  each  meteorological  station 
and  then  interpolated  to  every  point  on  the  computational 
grid.  The  influence  of  meteorological  station  data  on 
particular  points  on  the  computational  grid  will  be  deter¬ 
mined  by  each  station  proximity  to  the  particular  point  of 
interest . 

None . 


PATH:  o  END  WIND  FILE  BUILDING  ROUTINE 
Boundav  Condition  File  Building  routine 

43.  The  development  of  wave  conditions  in  a  given  location,  particular¬ 
ly  an  open  coastal  location,  usually  depends  on  two  forcing  factors- -the  wind 
and  the  waves  propagating  in  from  other  locations.  Hence,  any  accurate 
simulation  of  wave  development  at  a  given  location  must  consider  these 


7-59 


factors.  The  wind  input  for  a  SHALWV  simulation  is  discussed  in  Part  IV.  The 
input  of  wave  conditions  propagating  from  other  locations  is  discussed  below. 

44.  The  input  boundary  condition  option  in  SHALWV  provides  the  user 
with  a  technique  for  representing  wave  conditions  that  are  propagating  into 
the  region  that  is  being  simulated,  i.e.,  energy  derived  from  storm  conditions 
from  somewhere  outside  the  bounds  of  the  computational  grid.  The  Boundary 
Condition  File -Building  routine  allows  the  a  user  to  specify  the  type  of  input 
boundary  conditions  (and  corresponding  initial  conditions  as  described  in 
question  GF-27)  for  a  given  SHALWV  simulation.  The  utility  of  this  option  is 
shown  in  the  following  example.  If  a  user  wants  to  simulate  the  wave  condi¬ 
tions  for  a  certain  coastal  location,  the  entire  oceanic  basin  might  have  to 
be  modeled  to  ensure  that  the  waves  propagating  into  the  coastal  region  of 
interest  from  other  parts  of  the  ocean  basin  are  known.  Then,  to  refine  the 
calculation  of  wave  conditions  at  the  point  of  interest,  additional  SHALWV 
subgrid  simulations  (Part  II)  would  be  required.  The  disadvantage  is  that  the 
computational  time  required  to  model  the  entire  basin  and  any  additional 
subgrids  would  be  expensive.  To  alleviate  the  need  for  modeling  an  entire 
ocean  basin  and  one  or  more  subgrids,  input  boundary  conditions  may  be  used. 
For  example,  if  a  directional  wave  monitoring  buoy  was  positioned  near  the 
region  of  interest,  the  wave  information  from  that  buoy  could  be  used  to 
represent  the  energy  propagating  in  from  other  parts  of  the  ocean  basin. 

Hence,  a  single,  fine-resolution  grid  could  be  used  around  the  region  of 
interest,  saving  computational  time. 

45.  Input  boundary  conditions  may  be  specified  in  several  ways.  They 
may  be  specified  as  unchanging  throughout  the  simulation  (constant),  or  they 
may  be  specified  as  variable  over  time.  They  may  be  specified  by  simple  wave 
characteristics  like  the  energy-based  wave  height,  peak  spectral  period,  and 
mean  spectral  propagation  direction,  or  by  spectrally  based  parameters  like 
peak  spectral  frequency,  Phillip's  Equilibrium  constant,  and  the  spectral 
peakedness  and  width  factors.  Actual  one-  and  two-dimensional  spectra,  like 
that  which  is  measured  by  wave  buoys,  may  be  specified,  too.  If  constant 
input  boundary  conditions  are  specified,  the  wave  condition  descriptors 
(height,  period,  spectral  parameters,  etc.)  that  the  user  provides  will  be 
used  through  the  entire  simulation.  If  time-varying  input  boundary  conditions 
are  specified,  then  the  user  must  provide  the  wave  condition  descriptors  for 
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every  input  interval.  The  input  interval  must  be  equivalent  to  the  wind  input 
interval  (specified  in  question  GF-33  in  Part  IV  or  WF-3  in  Part  IV). 

46.  The  input  boundary  condition  information  that  is  provided  by  the 
user  is  input  along  the  borders  of  the  computational  grid.  The  user  may 
select  the  borders  (sides)  to  which  the  input  boundary  conditions  may  be 
applied.  They  will  always  be  applied  to  the  side  of  the  grid  through  which 
the  spectrum  is  primarily  propagating  (the  input  side).  The  input  boundary 
condition  information  that  is  provided  by  the  user  is  given  for  a  specified 
water  depth.  The  boundary  condition  program  BCGEN  assumes  that  the  specified 
depth  is  the  same  at  every  point  along  the  input  side  of  the  grid.  (This  is 
usually  a  reasonable  approximation.)  The  specified  boundary  conditions  are 
then  applied  to  every  point  along  the  input  side  of  the  grid.  The  user  may 
also  specify  whether  to  input  boundary  conditions  along  one  or  both  of  the 
grid  sides  to  the  left  or  right  of  the  input  side  of  the  grid.  The  input 
boundary  condition  information  is  transformed  based  on  depth  to  all  grid 
points  along  the  left  and/or  right  sides  of  the  grid. 

47.  The  descriptions  that  follow  outline  the  questions  with  which  the 
module  prompts  the  user  to  gather  information  for  generating  the  input 
boundary  conditions.  The  module  will  place  the  information  in  a  file,  and 
then  the  boundary  condition  program  BCGEN  must  be  run  to  transform  the 
boundary  conditions  to  the  specified  grid  points. 

Input  Descriptions 


BC-1  Question  :  General  File  Building  has  been  run?  (yes  or  no)  > 

Options  :  y  (or  Y)  -  General  File  Building  routine  has  been  run 

n  (or  N)  -  General  File  Building  routine  not  run 

Preselect:  None. 


Define  :  Some  of  the  files  generated  by  the  General  File  Building 
routine  must  exist  prior  to  using  the  Boundary  Condition 
File  Building  routine. 

Cautions  :  If  the  General  File  Building  routine  has  not  been  run  and 
yet  you  answer  yes ,  an  error  will  occur  when  the  Boundary 
Condition  File  Building  routine  searches  for  the  existence 
of  the  General  File  Building  routine's  files. 


PATH:  o  IF  GENERAL  FILE  BUILDING  ROUTINE  HAS  NOT  BEEN  RUN  (Option  'no', 

question  BC-1),  END  THE  BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 
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BC-2  Question  :  Enter  TIME  VARIATION  OPTIONS  > 

Options  1  -  Constant  wave/spectra  over  time 
2  -  Variable  wave/spectra  over  tine 
Preselect:  None. 

Define  The  input  boundary  conditions  may  be  specified  as  either 

time-varying  or  time -invariant.  If  time-varying  boundary 
conditions  are  selected,  you  will  be  prompted  for  boundary 
conditions  for  every  input  interval  of  the  simulation.  The 
input  interval  is  the  same  as  the  wind  input  interval  speci¬ 
fied  in  question  GF-33  in  Part  IV.  If  time- invariant  bound¬ 
ary  conditions  are  selected,  you  will  be  prompted  for  a 
single  set  of  boundary  condition  data  that  will  be  used  for 
the  entire  simulation  period. 

Cautions  :  None . 

BC-3  Question  :  Enter  BOUNDARY  CONDITION  OPTION  > 

Options  :  1  -  Input  wave  characteristics 

2  -  Input  spectral  characteristics 

3  -  Input  one -dimensional  frequency  spectrum 

4  -  Input  two-dimentional  frequency-direction  spectrum 
Preselect:  None. 

Define  :  You  must  specify  the  type  of  boundary  conditions  you  will  be 
based  providing.  Option  1  will  require  you  to  enter  energy 
wave  heights,  periods,  and  directions  as  boundary  condi¬ 
tions.  Option  2  will  require  you  to  enter  the  peak  spectral 
frequency,  Phillip's  Equilibrium  constant,  spectral  peaked- 
'  ness  factor,  and  the  spectral  peak-width  factors.  Options  3 

and  4  will  require  you  to  enter  either  the  one-  or 
two-dimensional  spectrum  as  appropriate. 

Cautions  :  None . 

PATH:  o  IF  ONE-DIMENSIONAL  SPECTRUM  IS  ENTERED  (Option  3,  question  BC-3), 
GO  TO  BC-5 . 

o  IF  TWO-DIMENSIONAL  SPECTRUM  IS  ENTERED  (Option  4,  question  BC-3), 
GO  TO  BC-9 . 

BC-4  Question  :  Enter  FREQUENCY  SPECTRAL  SHAPE  OPTION  > 

Options  :  1  -  Kittigoradski ,  deep  and  shallow 

2  -  Pierson-Moskowitz ,  deep  only 

3  -  JONSWAP,  deepwater  with  mean  values 

4  -  JONSWAP/TMA,  computed  alpha  and  gamma 
Preselect:  BC-3,  options  1  or  2 ; 

Define  :  When  the  input  boundary  conditions  will  not  be  given  as  an 
explicit  spectrum  (i.e.  one-  or  two-dimensional  spectrum) , 
then  you  must  specify  the  type  of  spectrum  that  should  be 
generated  based  on  the  wave  or  spectral  characteristics  you 


will  be  entering  later.  The  boundary  condition  program 
BCGEN  (see  Part  IV)  converts  the  wave  and  spectral  charac¬ 
teristics  into  a  one -dimensional  spectrum  based  on  the 
frequency  shape  factor  selected  here.  Option  4  is  recom¬ 
mended  . 

Cautions  :  None. 

BC-5  Question  :  Enter  DIRECTION  DISTRIBUTION  SHAPE  OPTION  > 

Options  :  1  -  cos"”# 

2  -  COS2p(|) 

Preselect:  BC-3,  option  1,  2,  or  3; 

Define  :  As  with  the  frequency  shape  factor  discussed  in  question  BC- 
4,  the  shape  of  the  spread  of  the  spectrum  across  the  direc¬ 
tion  domain  must  be  specified.  You  will  be  asked  later  to 
enter  the  value  for  'nn'  or  possibly  'p'  depending  on  the 
option  that  is  selected.  The  shape  of  the  directional 
spreading  will  be  applied  to  any  type  of  input  boundary 
condition  to  generate  a  two-dimensional  spectrum  except  when 
an  explicit  two-dimensional  spectrum  is  entered. 

Option  1  is  a  simplified  cosine  power  expression,  whereas 
Option  2  is  derived  from  the  work  of  Mitsuyasu  (1981).  You 
will  be  given  the  option  to  enter  the  value  of  'p'  in  op¬ 
tion  2  interactively  during  this  Boundary  Condition  File 
Building  routine,  or  to  have  it  computed  by  the  module. 

Cautions  :  None . 

PATH:  o  IF  cosZp(#/2)  SPREADING  FUNCTION  SELECTED  (Option  2,  question 
BC-5)  ,  GO  TO  BC-7 . 

BC-6  Question  :  Enter  SPECTRAL  SPREADING  FUNCTION  EXPONENT  > 

Options  :  Variable. 

Preselect:  BC-3,  options  1,  2,  or  3;  BC-5,  option  1. 

Define  :  The  spreading  function  exponent  is  the  value  of  nn  in  the 
expression  cos"”.  A  low  value  of  nn  (2,  3,  etc.)  will 
provide  a  wide  spread  in  direction  about  the  principal 
propagation  direction  of  the  spectrum.  Higher  values  for  nn 
(40,  200,  1000,  etc.)  provide  a  spectrum  with  decreasing 
directional  spread.  In  general,  a  value  of  4  may  be  used 
for  a  sea-wave  spectrum,  and  a  value  of  8  for  a  swell-wave 
spectrum. 

Cautions  :  None. 

PATH:  o  IF  cos™#  SPREADING  FUNCTION  SELECTED  (Option  1,  question  BC-5), 

GO  TO  BC-9 . 

BC-7  Question  :  Enter  rp*  COMPUTATION  OPTION  > 

Options  :  1  -  'p'  value  computed 

2  -  'p'  value  entered  interactively 

Preselect:  BC-3,  option  1,  2,  or  3;  BC-5,  option  2. 
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Define  The  value  for  p  in  the  term  cos2p(0/2)  may  be  entered  inter¬ 

actively  or  it  may  be  computed  by  the  module.  The  deriva¬ 
tion  of  p  is  based  on  the  work  of  Mitsuyasu  (1981). 

Cautions  :  None. 

PATH:  o  IF  'p'  VALUE  IS  COMPUTED  (Option  1.  question  BC-7),  GO  TO  BC-9. 

BC-8  Question  :  Enter  SPREAD  PARAMETER  > 

Options  :  Variable. 

Preselect:  BC-3,  options  1,  2,  3;  BC-5,  option  2;  BC-7,  option  2; 

Define  :  A  low  value  for  p  will  provide  a  spectrum  with  a  large 

directional  distribution  about  the  principal  direction  of 
propagation.  A  high  value  for  p  will  provide  a  spectrum 
with  a  small  directional  distribution  about  the  principal 
direction  of  propagation.  Recommended  values  are  8  for  a 
sea-wave  spectrum  or  16  for  a  swell  spectrum. 

Cautions  :  None. 

BC-9  Question  :  Enter  GRID  SIDE  from  which  vaves  are  coming  > 

Options  :  1 ,  2 ,  3 ,  or  4 

Preselect:  None. 

Define  :  The  sides  of  the  grid  are  defined  in  Figure  7-12.  For  the 

example  wave  direction  given  in  the  figure,  you  would  choose 
side  1  because  the  waves  are  primarily  propagating  through 
this  side,  although  they  also  propagate  through  side  2. 

Cautions  :  None. 

BC-10  Question  :  Enter  GRID  SIDE  TRANSFORMATION  OPTION  > 

Options  :  1  -  No  sides  are  transformed 

2  -  One  side,  left  of  input  side  is  transformed 

3  -  One  side,  right  of  input  side  is  transformed 

4  -  Two  sides,  left  and  right  sides  are  transformed 

Preselect:  None. 

Define  :  Besides  specifying  the  primary  side  of  the  grid  for  input 
boundary  conditions,  other  sides  of  the  grid  may  be  speci¬ 
fied.  When  another  side(s)  is  specified,  the  wave  charac¬ 
teristics  of  the  boundary  conditions  specified  for  the  input 
side  are  transformed  (refracted  and  shoaled)  to  the  speci¬ 
fied  side(s)  based  on  the  bathymetry  provided  during  the 
General  File  Building  routine  (Part  IV).  In  the  example  in 
Figure  7-12,  you  would  select  side  2  or  the  "right  side"  of 
the  input  side  (side  1)  for  entering  boundary  conditions 
because  the  waves  pass  through  this  side  somewhat  even 
though  they  primarily  pass  through  side  1. 

Cautions  :  None. 

BC-11  Question  :  Enter  the  Start  date  for  spectral  input  > 

Options  :  0  <  VALUE  5  99999999 


Preselect:  None. 

Define  The  date  for  the  first  input  boundary  condition  must  be 

specified.  The  module  automatically  computes  the  dates  for 
the  remaining  input  boundary  condition  data  based  on  the 
input  interval  (equivalent  to  the  wind  input  interval  speci¬ 
fied  in  question  GF-33  in  Part  IV). 

Cautions  :  The  value  should  be  consistent  with  the  date  for  the  first 
wind  input  data  (question  WF-12,  Part  IV). 

PATH:  o  IF  SPECTRAL  VAVE  CHARACTERISTICS  ARE  ENTERED  (Option  2,  question 
BC-3) ,  GO  TO  BC-17 . 

o  IF  ONE-DIMENSIONAL  SPECTRAL  DATA  ARE  ENTERED  (Option  3.  question 
BC-3),  GO  TO  BC-25. 

o  IF  TWO-DIMENSIONAL  SPECTRAL  DATA  ARE  ENTERED  (Option  4,  question 
BC-3).  GO  TO  BC-31. 

BC-12  Question  :  Enter  WAVE  TYPE  OPTION  > 

Options  :  1  -  Wind  sea  conditions 

2  -  Swell  conditions 

Preselect:  BC-3,  option  1. 

Define  SHALWV  simulates  both  sea  and  swell  created  by  winds  in  a 

two-dimensional  spectrum,  transforming  them  using  different 
methods.  Therefore,  you  must  identify  whether  the  input 
boundary  conditions  that  you  are  entering  are  locally  gener¬ 
ated  wind- sea  or  swell.  The  boundary  condition  program 
BCGEN  will  convert  the  wave  characteristics  that  you  enter 
into  a  two-dimensional  spectrum.  The  type  of  conversion 
depends  on  whether  the  waves  are  sea  or  swell.  This  ques¬ 
tion  will  be  repeated  for  each  input  interval  (same  as  the 
wind  input  interval  specified  in  question  GF-33  in  Part  IV) 
unless  constant  input  boundary  conditions  are  specified  in 
question  BC-2. 

Cautions  :  Improper  specification  of  sea  or  swell  may  lead  to  erroneous 
results . 

BC-13  Question  :  Enter  the  WAVE  HEIGHT  > 

Options  :  Variable. 

Preselect:  BC-3,  option  1. 

Define  :  You  must  enter  the  significant  (energy-based)  wave  height  to 
be  used  as  an  input  boundary  condition. 

Cautions  :  Units  must  be  in  meters. 

BC-14  Question  :  Enter  PEAK  WAVE  PERIOD  > 

Options  :  Variable. 

Preselect:  BC-3,  option  1. 
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Define  You  oust  enter  the  peak  wave  period  associated  with  the  wave 

height  identified  in  question  BC-13. 

Cautions  :  Units  must  be  in  seconds. 

BC  15  Question  :  Enter  MEAN  PROPAGATION  DIRECTION  > 

Options  :  0  s  VALUE  <  360 

Preselect:  BC-3,  option  1. 

Define  You  must  enter  the  mean  propagation  direction  of  the  wave 

identified  in  question  BC-13. 

Cautions  :  Units  oust  be  in  degrees  using  the  Cartesian  coordinate 
system  shown  in  Figure  7-5. 

BC- 16  Question  :  Enter  WATER  DEPTH  > 

Options  :  Variable. 

Preselect:  BC-3,  option  1. 

Define  :  You  must  enter  the  water  depth  associated  with  the  wave 

conditions  described  in  questions  BC-13  through  BC-15.  The 
water  depth  will  be  applied  to  every  point  along  the  input 
side  of  the  grid  (question  BC-9).  It  is  recommended  that  an 
average  depth  be  used  for  the  input  side  of  the  grid.  Dif¬ 
ferences  between  the  water  depth  entered  and  the  actual 
depths  along  the  input  side  of  the  grid  will  affect  only  the 
computations  at  the  subsequent  row  or  column. 

Cautions  :  Units  must  be  in  meters. 

PATH  :  o  IF  WAVE  CHARACTERISTICS  ENTERED  (Option  1,  question  BC-3),  END 
BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 

BC-17  Question  :  Enter  WAVE  TYPE  OPTION  > 

Options  1  -  Sea  wave  conditions 

2  -  Swell  wave  conditions 
Preselect:  BC-3,  option  2. 

Define  :  SHALWV  simulates  both  sea  and  swell  created  by  winds  in  a 

two-dimensional  spectrum.  The  spectral  parameters  that  the 
boundary  condition  program  BCGEN  converts  into  a  two-dimen¬ 
sional  spectrum  are  converted  based  on  whether  the  waves  are 
locally  generated  wind- sea  or  swell.  This  question  is 
repeated  for  each  input  interval  (same  as  the  wind  input 
interval  specified  in  question  GF-33  in  Part  IV)  unless 
constant  input  boundary  conditions  were  specified  in  ques¬ 
tion  BC-2 . 

Cautions  :  None. 

BC-18  Question  :  Enter  the  PEAK  SPECTRAL  FREQUENCY  > 

Options  :  >  0 

Preselect:  BC-3,  option  2. 
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Define 

Cautions  : 
BC-19  Question  : 
Options 
Preselect: 
Define  : 

Cautions  : 
BC-20  Question  : 
Options  : 
Preselect: 
Define  : 

Cautions  : 
BC-21  Question  : 
Options  : 
Preselect: 
Define  : 

Cautions  : 
BC-22  Question  : 
Options  : 
Preselect: 
Define  : 

Cautions  : 
BC-23  Question  : 
Options  : 
Preselect: 
Define  : 

Cautions  : 

BC-24  Question  : 
Options  : 
Preselect : 


The  peak  frequency  (fs)  of  the  spectrum  must  be  specified. 
(See  question  GF-27.) 

Units  must  be  in  Hertz  (Hz) . 

Enter  the  PHILLIP'S  EQUILIBRIUM  CONSTANT  > 

0  <  VALUE  £0.1 

BC-3,  option  2. 

The  Phillip's  Equilibrium  constant  for  the  spectrum  must  be 
specified.  (See  question  GF-27.) 

None. 

Enter  the  SPECTRAL  PEAKEDNESS  FACTOR  > 

1  <  VALUE  25  10 
BC-3,  option  2. 

The  "peakedness"  factor  for  the  spectrum  must  be  specified. 
(See  question  GF-27.) 

None . 

Enter  the  SPECTRAL  WIDTH  FACTOR  > 

0  <  VALUE  £0.2 
BC-3,  option  2. 

The  spectral  peak  width  factor  for  frequencies  below  the 
peak  frequency  must  be  specified.  (See  question  GF-27.) 

None. 

Enter  the  SPECTRAL  WIDTH  FACTOR  > 

0  <  VALUE  £0.2 
BC-3,  option  2. 

The  spectral  peak  width  factor  for  frequencies  above  the 
peak  spectral  frequency  must  be  specified.  (See  question 
GF-27.) 

None . 

Enter  the  MEAN  SPECTRAL  PROPAGATION  DIRECTION  > 

0  £  VALUE  <360 
BC-3,  option  2. 

The  mean  propagation  direction  of  the  spectrum  must  be 
specified.  The  directional  distribution  shape  (question  BC- 
5)  will  be  applied  about  the  mean  propagation  direction. 

Units  must  be  in  degrees  using  the  Cartesian  coordinate 
system  shown  in  Figure  7-5. 

Enter  the  WATER  DEPTH  > 

Variable . 

BC-3,  option  2. 
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Define  You  must  enter  the  water  depth  associated  with  the  spectral 

parameters  described  in  question  BC-18  through  BC-23.  The 
water  depth  will  be  applied  to  every  point  along  the  input 
side  of  the  grid  (question  BC-9).  It  is  recommended  that  an 
average  depth  be  used  for  the  input  side  of  the  grid. 
Differences  between  the  water  depth  entered  and  the  actual 
depths  along  the  input  side  of  the  grid  will  affect  only  the 
computations  at  the  subsequent  row  or  column. 

Cautions  :  Units  must  be  in  meters . 

PATH:  o  IF  SPECTRAL  CHARACTERISTICS  ENTERED  (Option  2,  question  BC-3),  END 
BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 

BC-25  Question  :  Enter  1-D  SPECTRA  INPUT  OPTION  > 

Options  :  1  -  Read  Headers  and  Spectra  from  a  file 

2  -  Enter  Headers  and  Spectra 

3  -  Enter  Headers ,  Read  Spectra 
Preselect:  BC-3,  option  3. 

Define  :  The  method  for  entering  the  one -dimensional  spectra  must  be 
specified.  The  Header  includes  the  values  for  the  wave  type 
option  (question  BC-27) ,  the  mean  spectral  propagation 
direction  (question  BC-28),  and  the  water  depth  for  the 
input  boundary  conditions  (question  BC-29).  If  the  Headers 
are  read  from  a  file,  then  questions  BC-27  through  BC-29 
will  not  be  asked.  The  data  format  is  discussed  in  Part  V. 


Cautions  :  If  option  2  or  3  is  selected,  you  will  be  required  to  input 
the  headers  and/or  the  spectra  interactively.  The  spectra 
must  contain  energy  density  values  for  each  frequency  band 
(see  description  for  question  GF-6  in  Part  IV)  for  each 
input  interval  (same  as  the  wind  input  interval  described  in 
question  GF-33  in  Part  IV)  unless  constant  boundary  condi¬ 
tions  are  selected  in  question  BC-2. 

PATH:  o  IF  SPECTRAL  DATA  ENTERED  INTERACTIVELY  (Option  2,  question  BC-25), 
GO  TO  BC-27. 

BC-26  Question  :  Enter  the  name  of  the  SPECTRAL  DATA  FILE  > 

Options  :  Variable. 

Preselect:  BC-3,  option  3;  BC-25,  options  1  or  3; 

Define  The  name  of  the  file  containing  the  one -dimensional  spectral 

data  must  be  entered. 

Cautions  :  If  the  name  entered  is  improper  or  incorrect  or  if  an  error 
occurs  while  the  module  reads  the  file,  the  Boundary  Condi¬ 
tion  File  Building  session  will  end.  No  information  will  be 
saved.  You  will  have  to  correct  the  file  before  rerunning 
the  Boundary  Condition  File  Building  routine. 

The  file  name  must  conform  to  the  file  naming  conventions  of 
the  UNIX  operating  system. 
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PATH:  o 


IP  SPECTRAL  DATA  AND  HEADERS  ARE  ENTERED  BY  FILE  (Option  1, 
question  BC-25),  END  BOUNDARY  CONDITION  PILE  BUILDING  ROUTINE. 


BC-27  Question  : 
Options 


Preselect: 

Define 


Cautions  : 

BC-28  Question  : 
Options  : 
Preselect : 
Define  : 


Cautions  : 

BC-29  Question  : 
Options  : 
Preselect : 
Define  : 


Enter  HAVE  TYPE  OPTION  > 

1  -  Wind  sea  conditions 

2  -  Swell  conditions 

3  -  Sea  and  Swell  conditions 

BC-3,  option  3;  BC-25,  options  2  or  3; 

The  type  of  wave  conditions  represented  by  the  one-dimen¬ 
sional  spectra  must  be  identified.  The  module  uses  differ¬ 
ent  spectral  transformation  methods  depending  on  whether  it 
is  a  sea  spectrum,  swell  spectrum,  or  combination  of  the 
two. 

Improper  specification  of  the  spectrum  may  lead  to  erroneous 
results . 

Enter  MEAN  SPECTRAL  PROPAGATION  DIRECTION  > 

0  <  VALUE  <  360 

BC-3,  option  3;  BC-25,  option  2  or  3; 

The  mean  direction  of  propagation  of  the  spectra  must  be 
specified.  The  module  will  apply  the  specified  directional 
distribution  shape  (question  BC-5)  about  the  mean  direction. 

Units  must  be  in  degrees  using  the  Cartesian  coordinate 
system  illustrated  in  Figure  7-5. 

Enter  WATER  DEPTH  > 

Variable 

BC-3,  option  3;  BC-25,  options  2  or  3; 

You  must  enter  the  water  depth  associated  with  the  spectra 
entered.  The  water  depth  will  be  applied  to  every  point 
along  the  input  side  of  the  grid  (question  BC-9).  It  is 
recommended  that  an  average  depth  be  used  for  the  input  side 
of  the  grid.  Differences  between  the  water  depth  entered 
and  the  actual  depths  along  the  input  side  of  the  grid  will 
affect  only  the  computations  at  the  subsequent  row  or  col¬ 
umn. 


Cautions  :  Units  must  be  in  meters. 


PATH:  o  IF  SPECTRAL  DATA  IS  ENTERED  BY  FILE  (Option  3,  question  BC-25), 
END  BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 

BC-30  Question  :  Enter  the  1-D  FREQUENCY  SPECTRA  > 

Spectral  Energy  Value  ##: 

Options  :  Variable 


Preselect:  BC-3,  option  3;  BC-25,  option  3; 
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Define  The  spectral  energy  density  values  must  be  entered  for  each 

frequency  band  in  the  spectrum.  (See  the  description  of 
spectral  energy  bands  in  question  GF-6  in  Part  IV). 

Cautions  :  Units  must  be  in  m2  /  Hz. 

PATH:  o  END  BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 

BC-31  Question  :  Enter  2-D  SPECTRA  INPUT  OPTION  > 

Options  :  1  -  Read  Headers  and  Spectra  from  a  file 

2  -  Enter  Headers,  Read  Spectra 
Preselect:  BC-3,  option  4; 

Define  The  method  for  entering  the  two-dimensional  spectra  must  be 

specified.  The  Header  includes  the  values  for  the  wave  type 
option  (question  BC-33),  the  water  depth,  the  wind  speed  and 
wind  direction. 

Cautions  :  None. 

BC-32  Question  :  Enter  the  name  of  the  SPECTRAL  DATA  FILE  > 

Options  :  Variable 
Preselect:  BC-3,  option  4; 

Define  :  The  Spectral  Data  File  name  must  be  provided.  This  file 

contains  the  two-dimensional  wave  energy  spectra  information 
in  the  format  described  in  Part  V. 

Cautions  :  The  file  name  must  conform  to  the  file  naming  conventions  of 
the  UNIX  operating  system.  If  no  file  name  is  provided  or 
an  error  is  encountered  when  the  module  reads  the  file,  the 
Boundary  Condition  File  Building  routine  will  end.  No 
information  will  be  saved.  You  must  correct  the  file  before 
the  Boundary  Condition  File  Building  routine  can  be  rerun. 

PATH:  o  IF  HEADERS  ARE  ENTERED  BY  FILE  (Option  1,  question  BC-31),  END 
BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE. 

BC-33  Question  :  Enter  WAVE  TYPE  OPTION  > 

Options  :  1  -  Wind  sea  conditions 

2  —  Swell  conditions 

3  -  Sea  and  Swell  conditions 
Preselect:  BC-3,  option  4;  BC-31,  option  2; 

Define  :  The  type  of  wave  conditions  represented  by  the  two-dimen¬ 
sional  spectra  must  be  identified.  The  module  operates  on 
the  spectrum,  depending  on  whether  it  is  a  locally  generated 
wind-sea  spectrum,  a  swell  spectrum,  or  a  combination  of  the 
two . 

Cautions  :  None. 

BC-34  Question  :  Enter  WATER  DEPTH  (m)  > 

Options  :  Variable 

Preselect:  BC-3,  option  4;  BC-31,  option  2; 
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Define  :  You  must  enter  the  water  depth  associated  vith  the  spectral 
entered.  The  water  depth  will  be  applied  to  every  point 
along  the  input  side  of  the  grid  (question  BC-9).  It  is 
recommended  that  an  average  depth  be  used  for  the  input  side 
of  the  grid.  Differences  between  the  water  depth  entered 
and  the  actual  depths  along  the  input  side  of  the  grid  will 
affect  only  the  computations  at  the  subsequent  row  or  col¬ 
umn. 

Cautions  :  Units  must  be  in  meters. 

BC-35  Question  :  Enter  WIND  SPEED  > 

Options  :  0  <  VALUE  <  100 

Preselect:  BC-3.  option  4;  BC-31,  option  2; 

Define  :  The  wind  speed  is  used  to  separate  the  spectrum  into  wind 
sea  and  swell  spectra.  It  is  assumed  that  energies  in 
spectral  frequencies  with  phase  speeds  greater  than  the  wind 
speed  are  part  of  the  swell  spectrum.  Those  energies  in 
spectral  frequencies  with  phase  speeds  less  than  the  wind 
speed  are  part  of  the  wind  sea  spectrum. 

Cautions  :  The  wind  speed  must  be  given  in  knots,  and  it  must  be  the 
equivalent  overwater,  10 -m  elevation,  neutrally  stable 
value.  If  you  selected  option  1  or  2  in  question  BC-33, 
then  the  spectrum  las  already  been  identified  as  sea  or 
swell,  and  the  wind  speed  entered  here  will  be  ignored. 

BC-36  Question  :  Enter  WIND  DIRECTION  > 

Options  :  0  <  VALUE  <  360 

Preselect:  BC-3,  option  4;  BC-31,  option  2; 

Define  :  Wind  direction  associated  with  wind  speed  entered  on  ques¬ 
tion  BC-35. 

Cautions  :  The  units  must  be  in  degrees  using  the  Cartesian  coordinate 
system  shown  in  Figure  7-5. 

PATH:  o  END  BOUNDARY  CONDITION  FILE  BUILDING  ROUTINE 


Function  to  Run  Programs 


48.  If  a  user  is  ready  to  run  the  module  pregrams  for  a  particular 
application,  then  the  task  of  composing  and  formatting  all  of  the  necessary 
input  data  into  the  proper  files  has  been  completed.  Running  the  programs 
only  entails  specifying  which  programs  should  be  run  and,  in  most  cases,  the 
onl>  program  chat  will  be  specified  is  SHALWV.  However,  there  may  be  cases 
where  input  and/or  output  boundary  conditions  are  specified  in  which  case  the 
BCGEN  program  and/or  the  INTERP  program  are  also  run. 
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Running  SHALWV 

49.  When  the  SHALWV  program  is  selected,  the  user  is  asked  to  specify  a 
reference  name  under  which  the  SHALWV  output  data  will  be  stored.  The 
reference  name  must  conform  to  the  file  name  conventions  of  the  UNIX  operating 
system  and  must  NOT  have  a  file  name  extension  like  ".dat"  or  ".out."  (The 
UNIX  file  naming  convention  is  14  significant  characters.)  The  module  uses 
the  reference  name  to  create  up  to  six  output  files  (described  in  Part  V), 
each  with  the  same  name,  but  with  different  extensions.  The  module  provides 
the  extensions  ".mtx",  ".spe",  ".sea",  ".bnd" ,  ".prp",  and  ".wrm." 

50.  The  first  output  file  created  by  SHALWV  is  the  Wave  Field  File 
(given  the  ".mtx"  extension),  which  contains  wave  characteristics  for  each 
grid  point  for  each  output  time  interval  (specified  in  question  GF-32  in  Part 
IV)  of  the  simulation.  The  second  output  file  is  the  Wave  Spectra  File  (given 
the  ".spe"  extension),  which  contains  the  one-  and  two-dimensional  spectra  for 
the  given  output  locations  (question  GF-36  &  G F-37  in  Part  IV)  for  each  output 
time  interval  of  the  simulation.  The  third  output  file  is  the  Wave  Character¬ 
istics  File  (given  the  extension  ".sea"),  which  contains  the  sea,  swell,  and 
combined  sea  and  swell  wave  characteristics  and  the  wind  speed  and  direction 
for  each  output  station  and  each  output  time  interval.  The  remaining  three 
SHALWV  output  files  are  optional.  The  first  of  the  optional  files  is  the 
Subgrid  Boundary  Condition  File  (given  the  extension  ".bnd”),  which  contains 
the  output  boundary  condition  data  that  will  be  interpolated  by  INTERP  for  use 
during  a  subsequent  SHALWV  simulation.  The  second  optional  file  is  the 
Preprocessing  File  (given  the  extension  ".prp"),  which  contains  all  of  the 
time- independent  variable  values  for  use  in  subsequent  SHALWV  simulations 
where  only  the  time-dependent  wave  conditions  will  be  calculated.  (See 
question  GF-2  in  Part  IV)  The  third  optional  output  file  is  the  Warm  Start 
File,  which  contains  wave  conditions  for  every  grid  point  for  use  in  initiali¬ 
zing  the  sea-state  for  a  subsequent  SHALWV  simulation.  (See  question  GF-26  in 
Part  IV) . 

Running  BCGEN 

51.  If  input  boundary  conditions  were  specified  in  question  GF-27  in 
Part  IV  and  subgrids  are  not  specified  in  question  GF-3  in  Part  IV,  then  the 
Boundary  Condition  File  Building  routine  (Part  IV)  must  be  used  to  build  the 
input  file  for  BCGEN.  The  BCGEN  program  is  then  run  prior  to  SHALWV  to 
generate  the  input  boundary  conditions  that  SHALWV  must  use.  Since  the  use  of 
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boundary  conditions  in  SHALWV  is  optional,  the  execution  of  BCGEN  is  also 
optional . 

Running  INTERP 

52.  When  subgrids  are  specified  in  question  GF-3  in  Part  IV,  then 
INTERP  must  be  run  to  interpolate  data  from  the  original  SHALWV  simulation  for 
use  as  input  boundary  conditions  for  the  subgrid  simulation.  Subgrids  are 
discussed  in  Part  II. 

53.  Note  that  to  run  subgrid  simulations,  an  original  grid  must  be  run 
previously  with  output  boundary  locations  specified  at  the  subgrid  boundaries. 
If  an  original  grid  has  not  been  run  or  the  output  from  the  original  simula¬ 
tion  has  been  deleted  or  removed  from  the  user's  working  directory,  then  a 
subgrid  simulation  cannot  be  conducted.  Also,  input  boundary  conditions  as 
generated  by  BCGEN  cannot  be  specified  during  a  subgrid  simulation  because 
input  boundary  conditions  must  be  obtained  from  the  original  SHALWV  simula¬ 
tion.  Hence,  BCGEN  and  INTERP  should  not  be  used  for  the  same  simulation. 

Function  to  Plot/Print  SHALWV  Output 

54.  Once  SHALWV  has  been  run  successfully,  the  module  may  be  used  to 
process  the  output  data.  Options  to  process  the  data  graphically  and  statis¬ 
tically  are  provided.  The  graphical  option  can  be  ust  c’  to  play  the 
following  plots  to  the  user's  terminal: 

a.  Bottom  bathymetry  contours  (Figure  7-14). 

b.  Wave-field  height  and  period  contours. 

c.  Wave-field  direction  vectors. 

d.  One-  and  two-dimensional  wave  energy  spectra  for  given  dates 
and  locations. 

e.  Wind  (Figure  7-15)  and  wave  histories  at  specified  locations. 

The  print  option  may  be  used  to  statistically  review  SHALWV  results  and  put 
the  following  information  into  files: 

a.  The  history  of  peak  wave  height  and  period  with  associated 
direction  at  specified  locations. 

b.  The  history  of  peak  wave  height  and  period  with  associated 
direction  throughout  the  modeled  region. 

c.  The  maximum,  minimum,  and  mean  wave  statistics  at  specified 
locations . 
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Example  Bathymetric  Contours 
(Units  in  Meters) 


Grid  Columns 

Figure  7-14.  Example  plot  of  bathymetric  contours. 

d.  The  maximum,  minimum  and  mean  wave  statistics  for  the  entire 
region  modeled. 

e.  The  one-  and  two-dimensional  spectral  energy  data  for  specified 
locations  for  specified  times. 

The  statistical  computations  may  be  displayed  to  the  user's  terminal  and/or 
written  to  a  file  for  transfer  to  the  user's  local  computer  for  printing. 

55.  The  data  that  may  be  evaluated  by  the  post-processing  options  is 
based  on  the  user-selected  output  data  time  interval  and  grid  node  location 
(questions  GF-32  and  GF-35).  When  necessary,  the  user  is  prompted  for  the 
desired  time  and  location  at  which  specified  data  are  required.  For  example, 
if  users  elect  to  graphically  display  the  wave  direction  vectors  for  the 
entire  grid,  they  will  be  prompted  for  the  date  at  which  the  information  is 
desired.  If  users  elect  to  review  minimum,  maximum,  and  mean  statistics  for  a 
given  location,  they  are  prompted  for  the  location. 
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Part  V:  SPECTRAL  WAVE  MODELING  MODULE  FILE  DESCRIPTIONS 

SHALWV  Files 

56.  The  organization  of  the  files  used  in  the  SHALWV  branch  of  the 
Spectral  Wave  Modeling  module  is  shown  in  Figures  7-9  through  7-11.  The  usage 
of  the  files  can  be  observed  by  determining  which  routines  in  the  SHALWV 
branch  of  the  module  create  the  files  and  then  which  routines  use  them.  This 
section  provides  a  brief  description  of  the  type  of  data  contained  in  each 
file  and  the  format  for  the  data  within  each  file.  A  list  of  the  files  used 
in  the  SHALWV  branch  of  the  modules  and  their  related  file  numbers  is  provided 
below.  The  reference  numbers  match  the  numbers  given  in  Figures  7-9  through 
7-11. 


File  Descriptions  and  Data  Formats 

57.  In  general,  the  creation,  organization,  and  usage  of  almost  all  of 
the  files  given  below  are  transparent  to  the  user.  The  Spectral  Wave  Modeling 
module  performs  these  tasks,  prompting  the  user  for  information  when  neces¬ 
sary.  Experienced  users  may  find  it  useful  to  circumvent  some  of  the  module 
functions  by  editing  and  formatting  data  files  themselves.  This  is  generally 
not  recommended  because  of  the  complexity  of  the  file  handling  systems.  The 
files  are  described  below. 

General  Inout  File 

58.  The  General  Input  File  is  one  of  the  files  built  by  the  General 
File  Building  routine  (Part  IV) .  The  General  Input  File  contains  program  flow 
control  parameters  for  SHALWV,  spectral  frequency  and  direction  discretization 
parameters,  computational  grid  parameters,  land/water  identifiers  for  each 
grid  node,  node  locations  for  output  of  model  results,  node  locations  for 
input  and  output  boundary  condition  data,  and  diffraction  information.  The 
format  for  the  General  Input  File  for  preprocessing  data  only  (option  1  in 
question  GF-2,  Part  IV)  follows  in  Table  7-1. 
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Table  7-1 


General  Input  File 

shalwin.  swv 

1 

Bathymetry  File 

depconst.swv, 
depvari.swv, 
or  user  specified 

2 

Land/Water  File 

user  specified 

3 

Diffraction  Data  File 

user  specified 

4 

Sheltering  Data  File 

user  specified 

5 

Subgrid  Interpolation  File 

intrpin. swv 

6 

Wind  Interpolation  File 

user  specified 

7 

Wind  Data  File  (used  by  SHALWV) 

user  specified 

8 

Spectral  Data  File 

user  specified 

9 

BCGEN  Input  File 

boundin. swv 

10 

Boundary  Condition  File  (for  SHALWV) 

boundout . swv 

11 

Subgrid  Boundary  Condition  File 

user  specified 

+  " .bnd” 

12 

Preprocess  File 

user  specified 

+  "  .prp" 

13 

Warm  Start  File 

user  specified 

+  " .wrm" 

14 

Wave  Field  Output  File 

user  specified 

+  " .mtx” 

15 

Wave  Spectra  Output  File 

user  specified 

+  ”.spe" 

16 

Wave  Characteristic  Output  File 

user  specified 

+  ".sea" 

17 

Parameter  File 

f ilel . swv 

18 

Main  File  Name  File 

f ilenmi . swv 

19 

Wind  File  Name  File 

f  ilenraw.  swv 

20 

Preprocess  File  Name  File 

f ilenrap . swv 

21 

Boundary  Condition  File  Name  File 

f tlenrab . swv 

22 

Warm  Start  File  Name  File 

f ilenmwr . swv 

23 

Post- Processing  File  Name  File 

f  ilennipst .  swv 

24 
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&.  RECORD  1,  Format  (15) 

Field  1  -  1  (indicates  preprocessing  run) 

fc.  RECORD  2,  Format  (615) 

Field  1  -  number  of  columns  in  grid 

Field  2  -  number  of  rows  in  grid 

Field  3  -  number  of  directional  angle  bands 

Field  4  -  number  of  frequency  bands 

Field  5  -  1  -  frequency  band  values  computed 

2  -  frequency  band  values  specified  by  user 
Field  6  -  1  -  water  depths  are  constant  over  grid 

2  -  water  depths  are  variable  over  grid 

c.  RECORD  3,  Format  (3F8.0,  F8.4) 

Field  1  -  distance  between  grid  points  (km) 

Field  2  -  a  scale  factor  used  in  refraction  computations  ex¬ 
pressed  as  a  percentage  of  the  distance  between  grid 
points.  A  value  of  10  is  recommended.  A  higher 
number  increases  computational  time  and  a  lower 
number  decreases  refraction  accuracy. 

Field  3  -  computational  time- step  (sec) 

Field  4  -  factor  to  convert  input  bathymetry  values  to  meters 

d.  RECORD  4 

If  Field  5  on  RECORD  2  is  1,  then  Format  (2F6.3) 

Field  1  -  Lowest  frequency  band  value 

Field  2  -  Frequency  band  value  interval 

If  Field  5  on  RECORD  2  is  2,  then  Format  (10F6.3) 

Field  1  through  10  -  Frequency  band  values.  Up  to  two 
RECORDS  may  be  used  for  input  of  frequency  values. 

e.  RECORD  5,  Format  (10011) 

Field  1  through  100  -  Array  designating  grid  points  as  water 
(1),  land  (0),  or  grid  boundary  (0).  This  matrix  must  have  the 
same  dimensions  as  and  be  consistent  with  the  bathymetry  data. 

59.  The  format  for  the  General  Input  File  for  computing  the  wave  field 

only  (option  2  in  question  GF-2,  Part  IV)  follows. 

a.  RECORD  1,  Format  (15) 

Field  1  -  2  (indicates  wave  calculation  only) 

b.  RECORD  2,  Format  (15) 

Field  1  -  1  -  cold  start,  no  save 

2  -  warm  start,  no  save 

3  -  cold  start,  save 
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d. 


e . 


Field  3 


Field  4 


4  —  warm  start,  no  save 

Field  2  -  1  -  No  input  or  output  boundary  conditions 

2  -  Output  boundary  conditions  only 

3  -  Input  boundary  conditions  only 

4  -  Input  &  output  boundary  conditions 

1  -  Constant  winds  over  space  and  time 

2  -  Time -varying  winds  only 

3  -  Time-  and  space -varying  winds 

1  -  No  bottom  effects 

2  -  Bottom  effects 
RECORD  3,  Format  (2F10.5) 

If  Field  4  on  RECORD  2  is  2,  then  this  card  is  used. 
Field  1  -  Bottom  friction  coefficient 
Field  2  -  Bottom  percolation  factor 
RECORD  4,  Format  (15) 

Field  1  -  Number  of  time  steps  between  output  results 
Field  2  -  Number  of  hours  between  input  winds 
Field  3  -  Maximum  number  of  wind  input 
Field  4  -  Number  of  special  output  locations  (^10) 
RECORD  5,  Format  (215) 


If  Field  4  on  RECORD  4  is  >  0,  then 

Field  1  -  Column  location  of  special  output  location 

Field  2  -  Row  location  of  special  output  location 

The  number  of  these  cards  must  be  equal  to  the  value  of  Field  4 
on  RECORD  4. 


NOTE:  The  remaining  cards  pertain  to  the  input  or  output  of 
boundary  information.  To  make  use  of  the  data  specified  by 
these  cards  the  BCGEN  or  INTERP  programs  must  be  run  prior  to 
SHALWV . 

f.  RECORD  6,  Format  (15) 

If  Field  2  on  RECORD  2  is  2  or  4,  then  this  card  is  used. 

Field  1  -  Number  of  computational  time-steps  between  out¬ 
put  of  boundary  condition  information  for  sub¬ 
grids  . 

g.  RECORD  7,  Format  (15) 

If  Field  2  on  RECORD  2  is  2  or  4,  then  this  card  is  used. 

Field  1  -  Number  of  subgrid  boundary  condition  output 
locations 
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fa.  RECORD  8,  Format  (215) 

If  Field  2  on  RECORD  2  is  2  or  4,  then  a  total  number  of  cards 
equal  to  the  value  in  Field  1  of  RECORD  7  must  be  provided. 

Field  1  •  Column  location  of  subgrid  output  location 

Field  2  -  Row  location  of  subgrid  output  location 

i.  RECORD  9,  Format  (15) 

If  Field  2  on  RECORD  2  is  3  or  4,  then  this  card  is  read. 

Field  1  -  Number  of  input  boundary  locations 

Field  2  -  The  column  location  of  the  first  corner  location 
for  boundary  condition  input 

Field  3  -  The  row  location  of  the  first  corner  location 
for  boundary  condition  input. 

Fields  2  and  3  are  repeated  for  the  each  additional  corner 
entered  for  input  of  boundary  conditions. 

j. .  RECORD  10,  Format  (215) 

If  Field  2  on  Card  2  is  3  or  4,  then  a  total  number  of  cards 
equal  to  the  value  entered  on  RECORD  7  must  be  provided. 

Field  1  -  Column  location  of  boundary  input  location 

Field  2  -  Row  location  of  boundary  input  location 

60.  The  format  for  the  General  Input  File  for  preprocessing  and 
computing  the  wave  field  together  (option  3  in  question  GF-2,  Part  IV)  is  a 
combination  of  the  format  for  "preprocessing  only"  and  "computing-waves  only." 

a.  RECORD  1,  Format  (15). 

Field  1  -  3  (indicates  a  preprocess  and  compute  waves  run) 

b .  RECORDS  2  through  5 . 

These  cards  are  identical  to  RECORDS  2  through  5  of  a  prepro¬ 
cessing  only  file. 

c.  RECORDS  6  through  13. 

These  cards  are  identical  to  RECORDS  2  through  10  of  a  "compute 
waves  only"  file. 

Bathymetry  File 

61.  The  bathymetry  file  can  be  built  during  operation  of  the  General 
File  Building  routine  (Part  IV).  However,  because  the  number  of  bathymetry 
data  is  usually  large,  it  is  recommended  that  users  build  this  file  using  the 
most  convenient  editor  available  to  them.  The  bathymetry  file  is  a  matrix  of 
numbers  indicating  the  depth  at  each  point  on  the  computational  grid.  (See 
questions  GF-18  through  GF-21  in  Part  IV  for  additional  information.)  Depth 
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values  may  be  entered  in  any  units  desired,  but  they  must  all  have  the  SAME 
units . 

If  Field  6  on  RECORD  2  of  the  General  Input  File  is  1,  then  Format 

(F6.0). 

Field  1  -  Uniform  (constant)  water  depth  value.  If  F  eld  6  on 
RECORD  2  of  the  General  Input  File  is  2,  then  Format 
(21F6.0). 

Field  1-21  -  Matrix  of  depth  values  for  each  point  on  the 

computational  grid.  Note  that  this  matrix  must 
match  the  Land/Water  matrix.  Values  equal  to 
(0.0)  are  assumed  to  be  land. 

Note:  Only  21  values  are  allowed  per  row.  If  the  computa¬ 
tional  grid  has  more  than  21  values  on  a  row,  then  21  values 
are  entered  on  the  first  card  and  the  remaining  numbers  are 
placed  on  additional  cards  until  the  entire  row  of  values  has 
been  entered.  The  next  row  of  the  computational  grid  begins  on 
a  new  card. 

62.  An  option  is  available  in  the  General  File  Building  routine  which 
allows  you  to  build  the  Land/Water  file  (see  next  file  description)  based  on 
the  values  in  the  Bathymetry  File.  The  General  File  Building  routine  reads 
the  Bathymetry  File  and  assigns  land  values  to  grid  points  with  depths  equal 
to  (0.0)  and  to  the  grid  borders.  All  other  points  are  assigned  water  values. 
Land/Water  File 

63.  The  Land/Water  File  can  be  built  by  the  General  File  Building 
routine  or  read  from  a  file  (Part  IV) .  An  option  is  available  within  the 
General  File  Building  which  allows  the  user  to  create  the  Land/Water  file 
based  on  the  bathymetry  data  values.  (See  Bathymetry  File  Description.)  The 
Land/Water  File  is  a  matrix  of  ones  (1)  and  zeroes  (0)  al  Fh  indicates  whether 
a  grid  point  is  a  land  point  (or  grid  border),  or  water  point,  respectively. 
The  dimensions  of  the  Land/Water  File  data  must  be  the  same  as  the  data  in  the 
Bathymetry  File.  The  Land/Water  File  is  placed  within  the  General  Input  File 
by  the  General  File  Building  routine.  The  above  description  of  the  General 
Input  File  shows  how  the  Land/Water  data  is  positioned. 

RECORD  1,  Format  (10011) . 

Field  1  through  100  -  Enter  a  one  (1)  or  a  zero  (0)  for  each 
grid  point  along  a  row  of  the  computational  grid.  Subsequent 
rows  of  the  grid  must  be  provided  on  additional  RECORDS. 

Diffraction  Data  File 

64.  The  Diffraction  Data  File  contains  data  required  by  SHALWV  to 
perform  diffraction  computations.  The  data  include  the  locatioon  on  the  grid 
of  the  diffracting  point  and  the  position  of  the  diffracting  structure.  These 
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data  are  described  in  Part  II  and  in  question  GF-55  in, Part  IV.  These  data 
may  also  be  entered  interactively  during  the  General  File  Building  Routine 
(Part  IV) .  The  format  for  the  data  within  the  file  is  given  below, 
g.  RECORD  1,  Free  Format. 

Field  1  •  Column  locatioon  of  diffracting  point. 

Field  2  -  Row  location  of  diffracting  point. 

Field  3  -  Position  number  of  diffracting  structure, 
fe.  RECORD  2. 

Repeat  RECORD  1  for  additional  diffraction  locations. 

Sheltering  -Data  ills 

65.  The  Sheltering  Data  File  contains  data  required  by  SHALWV  to  reduce 
wave  energy  to  user-specified  levels  at  user- specified  locations.  The  data 
include  the  sheltered  point's  location  on  the  grid,  as  well  as  coefficients 
which  specify  the  amount  of  energy  reduction  per  angle  band  within  the  energy 
spectrum.  These  data  described  in  Part  II  and  questioon  GF-61  in  Part  IV. 

The  data  may  also  be  entered  interactively  via  the  module  as  described  In 
Part  IV.  The  format  for  the  data  within  the  file  is  given  below. 

g.  RECORD  1,  Free  Format. 

Field  1  -  Column  location  of  sheltered  point. 

Field  2  -  Row  location  of  sheltered  point. 

Field  3-18  -  Sheltering  coefficient  for  each  of  the  16  angle 
bands  in  the  spectrum  incremented  from  0°  by 
22.5*  steps. 

Note : 

(1)  Sixteen  direction  bands  is  default  value  when  sheltering 
is  used. 

(2)  Coefficient  indicates  percent  sheltered,  e.g.,  a  coeffi 
cient  of  one  indicates  100  percent  sheltered. 

fe.  RECORD  2. 

Repeat  RECORD  1  for  any  additional  sheltered  locations. 

Subgrid  Interpolation  File 

66.  The  Subgrid  Interpolation  File  is  an  optional  file  created  by  the 
General  File  Building  routine  and  is  needed  only  when  a  subgrid  of  an  original 
computational  grid  is  being  used.  The  Subgrid  Interpolation  File  contains 
parameter  values  that  control  operation  of  the  subgrid  input  boundary  condi¬ 
tion  interpolation  program,  INTERP.  The  INTERP  interpolates  the  output 
boundary  condition  information  from  an  original  SHALWV  simulation  to  the  input 
boundary  locations  of  a  subgrid.  (See  Part  II  for  a  description  of  subgrids.) 
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It  is  recommended  that  users  not  modify  this  file  except  through  the  General 
File  Building  routine.  The  General  File  Building  routine  will  keep  track  of 
the  association  between  input  and  output  boundary  locations  and  maintains 
complete  consistency  between  general  program  control  parameters  for  the 
original  SHALW  simulation  and  the  subgrid  simulation, 
a.  RECORD  1,  Format  (815). 


Field  1  - 
Field  2  - 
Field  3  - 

Field  4  - 

Field  5  - 

Field  6  - 
Field  7  - 
Field  8  - 

b .  RECORD  2 . 


Number  of  Columns  in  Subgrid. 

Number  of  Rows  in  Subgrid. 

Number  of  output  boundary  condition  locations  on 
original  grid. 

Number  of  input  boundary  condition  locations  on 
subgrid. 

Ratio  between  length  of  original  and  subgrid  cell 
lengths . 

Number  of  frequency  bands  in  spectrum. 

Number  of  direction  bands  in  spectrum. 

1  -  frequency  bands  were  computed. 

2  -  frequency  bands  were  entered  by  user. 


If  Field  5  on  RECORD  2  of  the  General  Input  File  (see  above)  is 
one  (1),  then  FORMAT  (2F7.4). 

Field  1  -  Initial  frequency  band  value. 

Field  2  -  Interval  value  between  frequency  bands. 

If  Field  5  on  RECORD  2  of  the  General  Input  File  (see  above)  is 
two  (2),  then  FORMAT  (10F7.4). 

Field  1  through  10  -  Frequency  band  values  for  the  number  of 

frequency  bands  specified  on  Field  4  of 
RECORD  2 .  If  more  then  10  values  are 
required  an  additional  card  may  be  used. 

RECORD  3,  Format  (F8.4). 

Field  1  -  Depth  conversion  factor. 

RECORD  4,  Format  (315). 

This  card  is  repeated  for  each  input  boundary  location  on  the 
subgrid. 

Field  1  -  Input  boundary  condition  column  location. 

Field  2  -  Input  boundary  condition  row  location. 

Field  3  -  0  -  point  does  not  correspond  with  a  point  on  the 

original  grid. 

1  -  point  corresponds  with  a  point  on  the  original 
grid. 
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Wind  Input  File  (used  bv  SHALWV) 

67.  The  Wind  Input  File  contains  the  vind  input  data  formatted  for  use 
by  SHALWV.  This  is  in  contrast  to  the  Wind  Interpolation  File,  which  contains 
meteorological  station  information  that  is  used  to  generate  a  Wind  Input  File 
by  the  Wind  File  Building  routine  (Part  IV) .  Because  of  the  method  used  to 
keep  track  of  files  within  the  module,  it  is  recommended  that  the  Wind  Input 
File  be  passed  through  the  Wind  File  Building  routine  (Part  IV)  so  that  the 
module  can  "tag"  the  file  for  use.  The  Wind  Input  File  may  be  created  outside 
the  module  on  the  user's  preferred  editor,  but  the  name  of  the  file  should  be 
given  to  the  module  through  the  Wind  File  Building  routine . 

68.  The  Wind  Input  File  is  required  for  any  SHALWV  simulation  except  a 
"preprocessing  data  only"  simulation.  A  wind  field  can  be  input  as  either  a 
single  card  specifying  a  uniform  and  constant  wind  speed  and  wind  direction 
over  the  entire  grid,  or  in  the  form  of  matrices  that  give  the  wind  speed  and 
direction  at  each  grid  point.  The  wind  file  can  contain  any  number  of  wind 
fields,  but  it  must  contain  at  least  two  (for  nonconstant  wind  fields). 

Uniform  and  Constant  Wind  Field 

69.  The  Uniform  and  Constant  Wind  Field  is  specified  in  Field  3  of 
RECORD  6  of  the  General  Input  File  for  both  preprocessing  and  computing  waves. 

RECORD  1,  Format  (2F6.1). 

Field  1  -  Uniform  wind  speed  in  knots.  Assumed  overwater, 
neutrally  stable  atmospheric  conditions  at  the 
10-m  elevation. 

Field  2  -  Uniform  wind  direction  in  degrees  over  entire  grid 
expressed  in  Cartesian  system. 

Time-Varying  Wind  Field  File 

70.  Time-Varying  Wind  Field  File  is  specified  in  Field  3  of  RECORD  6  of 

the  General  Input  File  for  both  preprocessing  and  computing  waves. 

RECORD  1,  Format  (I10.2F6.1)  (This  card  is  repeated  for  the  number 
of  wind  inputs  desired  and  specified  in  the  General  Input  File.) 

Field  1  -  Date  in  the  form  'yymmddhh' 

Field  2  -  Same  as  Field  1  for  constant  winds 

Field  3  -  Same  as  Field  2  for  constant  winds 
Time-  and  Space-Varying  Wind  Field  File 

71.  The  Time-  and  Space  Varying  Wind  Field  File  is  specified  in  Field  3 
of  RECORD  6  of  the  General  Input  File  for  both  preprocessing  and  computing 
waves.  The  wind  field  data  are  entered  differently  than  the  data  for  the 
bathymetry.  For  example,  if  the  computational  grid  has  more  than  21  columns, 
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say  30,  then  the  first  21  columns  are  read  for  all  rows  of  the  grid  for  wind 
speed,  and  then  the  firsc  21  columns  are  read  for  all  rows  for  wind  direction. 
Then,  the  remair. ing  9  columns  for  all  rows  are  read  for  wind  speed,  and  then 
the  remaining  9  columns  for  all  rows  are  read  for  wind  direction. 

&.  RECORD  1,  Format  (110). 

Field  1  -  Date  in  th.’  form  'yymmddhh'  . 

b.  RECORD  2,  Format  (21F6.1)  (This  card  is  repeated  as  necessary 
to  input  all  of  the  wind  values . ) 

Field  1  through  21  -  Wind  speeds  as  defined  in  Field  1  of  the 

constant  wind- field  file  description. 

A  card  for  every  row  is  entered  containing  the  first  21  columns 
of  wind  data. 

c.  RECORD  3,  Format  (21F6.1). 

Field  1  through  21  -  Wind  directions  as  defined  in  Field  2  of 

the  constant  wind-field  file  description. 

RECORDS  2  and  3  are  repeated  until  all  ct-^’juns  of  the  grid  have  been 

entered.  RECORDS  1,  2,  and  3  are  repeated  until  all  the  wind  data  for 

the  simulation  have  been  encered. 

Wind  Interpolation  File  (provide^ 
by  user  to  Wind  File  Building  routine) 

72.  The  Wind  File  Building  routine  has  the  provision  to  interpolate 
wind  data  from  meteorological  stations  located  over  the  water  (e.g.  buoy  data) 
to  every  point  on  the  computational  grid. 

a.  RECORD  1,  Free  Format. 

Field  1  -  number  of  stations  included  in  the  interpolation 
(max.  100) . 

b.  RECORD  2,  Free  Format. 

Enter  the  column  locatior  for  every  meteorological  station. 

c.  RECORD  3,  Free  Format. 

Enter  the  row  location  for  every  meteorological  station  in  the 
same  order  used  on  RECORD  2. 

d.  RECORD  4,  Free  Format. 

Enter  the  wind  speed  and  direction  for  each  station  for  the 
first  wind  input  interval.  On  additional  cards,  add  the  wind 
speed  and  direction  for  each  station  for  the  remaining  wind 
input  intervals. 

BCGEN  Input  File 

73.  The  BCGEN  Input  File  is  generated  by  the  Boundary  Condition  File 
Building  routine  to  be  used  as  input  to  the  BCGEN  program.  The  BCGEN  Input 
File  contains  the  program  control  parameters  and  necessary  information  for 
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generating  boundary  conditions  at  user-specified  locations  on  the  computation¬ 
al  grid.  It  is  recommended  that  this  file  be  created  and  modified  only 
through  the  Boundary  Condition  File  Building  routine,  so  that  consistency  can 
be  maintained  in  file  organization  and  program  control  parameters. 

RECORD  1,  Format  (215). 

Field  1  -  1  -  Boundary  Conditions  are  constant. 

2  -  Boundary  Conditions  are  time -varying. 

Field  2  -  1  -  Wave  characteristics  are  specified. 

2  -  Wave  spectral  parameters  are  specified. 

3  -  One -Dimensional  spectra  are  specified. 

4  -  Two-Dimensional  spectra  are  specified, 
b.  RECORD  2,  Format  (815). 

Field  1  -  Number  of  spectral  frequency  bands . 

Field  2  -  Number  of  spectral  direction  bands. 

Field  3  -  0  -  frequency  band  values  are  computed. 

1  -  frequency  band  values  are  entered. 

Field  4  -  Spectral  shape  criteria  where: 

1  -  Kittigoradskii 

2  -  Pierson-Moskowitz 

3  -  JONSWAP 

4  -  TMA 

Field  5  -  Spectral  spreading  function  where: 

1  -  cos™ 

2  -  cos2p  (Gamma  Function) 

Field  6  -  Specifies  the  side  of  the  computational  grid  through 
which  the  spectrum  is  principally  propagating.  (See 
question  BC-9  for  definition.) 

Field  7  -  Specifies  whether  more  than  one  side  of  the  computa¬ 
tional  grid  are  given  input  boundary  conditions. 

(See  question  BC-10  for  definition.)  Note  that: 

0  -  no  other  sides 

1  -  left  side  only 
-1  -  right  side  only 

2  -  both  left  and  right  sides 

Field  8  -  Specifies  method  for  determining  'p'  in  spectral 
spreading  function  specified  in  Field  5  where: 

0  -  'p'  computed 

1  -  'p'  entered 
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£.  RECORD  3,  Format  (15)  If  Field  5  on  RECORD  2  is  1,  then  this 
card  is  used. 

Field  1  -  nn,  the  spectral  spreading  exponent. 

d.  RECORD  4,  Format  (F5.1)  If  Field  5  on  RECORD  2  is  2  and 
Field  8  on  RECORD  2  is  1,  then  this  card  is  used. 

Field  1  -  p,  the  spectral  spreading  exponent. 

e.  RECORD  5,  Format  (10F7.4)  If  Field  3  on  RECORD  2  is  1,  then 
this  card  is  used. 

Field  1  through  10  -  frequency  band  values  (Hz).  An  Additional 

card  may  be  used. 

£.  RECORD  6,  Format  (2F7.4)  If  Field  3  on  RECORD  2  is  0,  then 
this  card  is  used. 

Field  1  -  Initial  frequency  band  value. 

Field  2  -  Frequency  band  value  interval. 

g .  RECORD  7 ,  Format  (15). 

Field  1  -  Maximum  number  of  input  intervals. 

h.  RECORD  8,  Format  (15). 

Field  2  -Number  of  input  boundary  condition  locations. 

i.  RECORD  9,  Format  (315,  F8.2). 

Field  1  -  Grid  input  side  identifier  where: 

0  -  Main  input  side 

1  -  Input  side  to  the  left  of  the  main  side 

-1  -  Input  side  to  the  right  of  the  main  side 

Field  2  -  Input  boundary  condition  column  location. 

Field  4  -  Input  boundary  condition  row  location. 

Field  5  -  Depth  at  input  boundary  condition  location. 

This  card  is  repeated  for  each  input  boundary  condition  loca¬ 
tion.  If  Field  2  of  RECORD  1  is  1,  then  this  card  is  used.  A 
card  is  required  for  each  input  time  interval. 

X.  RECORD  10,  Format  (15,  4F6.1,  110). 

Field  1  -  Wave  type  option 

Field  2  -  Wave  height  (m) 

Field  3  -  Wave  period  (sec) 

Field  4  -  Wave  propagation  direction  (°  Cartesian) 

Field  5  -  Water  depth  (m) 

Field  6  -  Date/time  for  input  (yymmddhh) 

If  Field  2  of  RECORD  1  Is  2,  then  this  RECORD  is  used.  A  card 
is  required  for  each  input  time  interval. 

fc.  RECORD  11,  Format  (15,  2F6.4,  2F6.1,  F6.1,  F7.2,  110). 
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Field  1  -  Wave  type  option. 

Field  2  -  Peak  spectral  frequency  (Hz),  fn. 

Field  3  -  Phillip's  Equilibrium  Constant,  a. 

Field  4  -  Spectral  peakedness  factor,  y. 

Field  5  -  Frequency  shape  factor,  o%. 

Field  6  -  Frequency  shape  factor,  ab. 

Field  7  -  Mean  propagation  direction  (°  Cartesian). 

Field  8  -  Water  depth  (m) . 

Field  9  -  Date/time  for  input  (yymmddhh) . 

If  Field  2  of  RECORD  1  is  3,  then  RECORD  12  and  13  are  used.  A 
set  of  cards  is  required  for  each  input  time  interval. 

k.  RECORD  12,  Format  (15,  2F6.1,  110). 

Field  1  -  Wave  type  option. 

Field  2  -  Mean  propagation  direction  (#  Cartesian). 

Field  3  -  Water  depth  (m) . 

Field  4  -  Date/time  for  input  (yymmddhh) . 

l.  RECORD  13,  Format  (10F6.2). 

Field  1  through  10  -  Spectral  energy  values  for  each  frequency 

band  in  m2/Hz.  Values  must  be  provided 
from  lowest  to  highest  frequency  band. 

An  additional  card  may  be  used  for  more  frequency  bands . 

If  Field  2  of  RECORD  1  is  4,  then  RECORD  14  and  15  are  used.  A  set 
of  cards  is  required  for  each  input  time  interval. 

m.  RECORD  14,  Format  (15,  3F6.1,  110). 

Field  1  -  Wave  type  option. 

Field  2  -  Water  depth  (u) . 

Field  3  -  Wind  speed  (knots). 

Field  4  -  Wind  direction  (®  Cartesian). 

Field  5  -  Date/time  for  input  (yymmddhh) . 

n.  RECORD  15,  Format  (16F8.5). 

Field  1  through  10  -  Spectral  energy  values  for  each  direction 

band  for  a  given  frequency  band  (units  are 
mz/(Hz ■ rad) ) .  Values  must  be  provided 
starting  with  the  0°  band  and  the  lowest 
frequency  band. 

Additional  cards  may  be  used  for  more  frequency  bands. 

Spectral  Data  File 

74.  The  Spectral  Data  File  contains  wave  energy  spectra  that  the 
Boundary  Condition  File  Building  routine  (Part  IV)  uses  to  generate  boundary 
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conditions  for  SHALWV.  The  Spectral  Data  File  may  contain  either  one-  or  two- 
dimensional  spectral  information  for  each  input  time-step  (same  as  the  wind 
input  time-step  specified  in  question  GF-33  in  Part  IV).  If  time -invariant 
boundary  conditions  are  specified  during  the  Boundary  Condition  File  Building 
routine,  then  only  one  spectrum  is  required  for  each  input  station.  Descrip¬ 
tions  for  the  question  numbers  provided  with  the  file  data  format  below  can  be 
found  in  Part  IV. 


One -Dimensional  Input  Boundary  Condition  Spectra 

a.  RECORD  1,  Free  Format. 

This  card  is  only  used  if  Headers  are  specified  as  being  read 
from  a  file  during  the  Boundary  Condition  File  Building  rou¬ 
tine  . 

Field  1  -  Wave  type  option  (question  BC-27). 

Field  2  -  Mean  propagation  direction  (question  BC-28). 

Field  3  -  Water  depth  (question  BC-29). 

b.  RECORD  2,  Free  Format. 

The  fields  on  this  card  are  filled  (up  to  132  characters/card) . 
Several  cards  may  be  used  to  enter  all  of  the  spectral  values . 
The  frequency  values  should  be  in  units  of  m2/Hz.  The  values 
should  be  provided  from  the  lowest  to  the  highest  frequency 
band. 


RECORDS  1  and  2  are  repeated  for  each  data  input  time. 


Two-Dimensional  Input  Boundary  Condition  Spectra 
£.  RECORD  1,  Free  Format. 


This  card  is  only  used  if  Headers  are  specified  as  being  read 
from  a  file  during  the  Boundary  Condition  File  Building  rou¬ 
tine  . 


b. 


Field  1  - 
Field  2  - 
Field  3  - 
Field  4  - 
RECORD  2, 


Wave  type  option  (question  BC-32). 
Water  depth  (question  BC-33). 

Wind  speed  (question  BC-34). 

Wind  direction  (question  BC-35). 
Free  Format. 


The  fields  on  this  card  are  filled  (up  to  132  characters/card) 
until  all  of  the  spectral  values  for  a  given  frequency  are 
entered.  Several  cards  may  be  used.  The  spectral  energy  is 
entered  for  each  direction  band  for  a  given  frequency  beginning 
with  the  band  at  0°  in  a  Cartesian  coordinate  system.  (See 
Figure  7-5.)  After  the  values  for  each  direction  in  a  frequen¬ 
cy  band  have  been  entered,  a  new  frequency  band  is  selected  and 
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a  new  card  must  be  used.  Several  cards  may  be  used.  The 
frequency  values  should  be  in  units  of  m2/(Hz-rad).  The  data 
should  be  provided  from  the  lowest  to  the  highest  frequency 
band. 

RECORDS  1  and  2  are  repeated  for  each  data  input  time  interval. 
Boundary  Condition  File  (for  SHALWV) 

75.  The  Boundary  Condition  File  (for  SHALWV)  is  output  from  the  BCGEN 
program,  which  is  used  to  generate  input  boundary  conditions  for  a  given 
SHALWV  simulation.  The  data  for  this  file  are  written  in  binary,  and  there¬ 
fore  the  format  is  not  described. 

Subgrid  Boundary  Condition  File 

76.  The  Subgrid  Boundary  Condition  File  is  created  by  SHALWV  for  use  by 
INTERP.  SHALWV  fills  the  file  with  boundary  condition  information  for  a 
subsequent  subgrid  simulation.  INTERP  interpolates  the  data  to  fit  the 
subgrid  cell  size.  The  data  are  written  to  the  file  in  binary  form.  There¬ 
fore,  format  and  data  within  the  file  are  not  described. 

Preprocess  File 

77.  The  Preprocess  File  is  generated  by  SHALWV.  It  contains  all  of  the 
time- independent  parameters  for  a  given  application.  It  is  accessed  by  SHALWV 
in  future  simulations  where  the  wave  fields  are  calculated  (i.e.,  where  only 
the  time -dependent  values  are  calculated).  The  file  is  written  in  binary; 
therefore,  the  file  data  and  format  are  not  described. 

Warm  Start  File 

78.  The  Warm  Start  File  is  generated  by  SHALWV  at  the  end  of  a  simula¬ 
tion.  The  Warm  Start  File  is  used  to  initialize  the  two-dimensional  spectrum 
at  every  computational  grid  point  for  a  subsequent  SHALWV  simulation,  which 
therefore  can  continue  the  previous  simulation.  This  process  removes  discon¬ 
tinuities  between  individual  segments  of  a  long  simulation.  The  file  data  are 
written  in  binary;  therefore,  the  file  data  and  format  are  not  described. 

Wave  Field  Output  File 

79.  The  Wave  Field  Output  File  contains  the  energy-based  significant 
wave  height,  the  peak  spectral  period,  and  the  mean  spectral  direction  of 
propagation  for  each  point  on  the  computational  grid  for  each  output  time-step 
as  specified  in  question  GF-32  in  Part  IV.  The  data  are  oriented  in  the  file 
for  a  given  output  interval  with  the  matrix  of  wave  heights  provided  first, 
followed  by  the  wave  period,  and  then  the  direction. 
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Wav«  Spectra  Output  File 

80.  The  Spectra  Output  File  contains  the  two-dimensional  energy  spectra 
for  each  output  station  specified  In  questions  GF-35  and  GF-36  for  each  output 
time  interval  specified  In  question  GF-32  In  Part  IV.  The  first  line  contains 
(from  left  to  right)  the  date,  the  column  and  row  for  the  output  location,  the 
assigned  station  number,  the  wind-sea  spectral  parameters  including  the 
Phillips'  Equilibrium  constant,  peak  spectral  frequency,  spectral  peakedness 
factor,  frequency  band  number,  wave  direction  band  number  (in  5°  intervals), 
mean  direction  of  the  wind  sea  (in  radians),  wave  number,  and  amount  of  energy 
in  the  parametric  region  of  the  spectrum. 

81.  The  matrix  that  follows  the  first  line  contains  both  the  one-  and 
two-dimensional  spectrum,  the  specified  location,  and  date.  The  first  column 
contains  the  one -dimensional  (in  frequency)  wave  energy  spectrum  (cm2).  The 
top  of  the  column  corresponds  to  the  lowest  frequency.  The  frequency  values 
associated  with  the  energy  values  in  the  first  column  were  specified  through 
questions  GF-6  and  GF-14  (or  GF-6,  GF-15,  and  GF-16).  The  other  columns 
contain  the  two-dimensional  spectrum  in  cm2.  Each  row  corresponds  to  the  same 
frequency  as  the  frequency  in  the  adjacent  one -dimensional  spectrum.  The  two- 
dimensional  spectrum  is  always  output  using  only  16  direction  bands  regardless 
of  what  was  specified  In  question  GF-7  in  Part  IV.  The  first  column  corre¬ 
sponds  to  the  direction  band  CENTERED  ON  0  deg.  Each  direction  band  is  22.5 
deg  wide. 

Wave  Characteristic  Output  File 

82.  The  Wave  Characteristics  Output  File  contains  the  energy-based  wave 
height,  peak  spectral  period,  and  mean  spectral  propagation  direction  for  the 
total  energy  spectrum,  the  wind- sea  spectrum,  and  the  swell  spectrum,  as  well 
as  the  wind  speed  and  direction  for  the  output  locations  specified  in  ques¬ 
tions  GF-35  and  GF-36  for  each  output  interval  specified  by  question  GF-32  in 
Part  IV.  The  numbers  in  each  row  have  the  following  definitions:  (from  left 
to  right) 

1.  The  date  (yymmddhhmm) . 

2.  The  location  identifying  number  (station  number). 

3.  The  column  and  row  of  the  output  location. 

4.  The  wave  height  of  the  total  spectrum  (m) . 

5.  The  peak  period  of  the  total  spectrum  (sec). 

6.  The  mean  propagation  direction  of  the  total  spectrum 
(°  Cartesian). 
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7 .  The  wave  height  of  the  sea  spectrum  (m) . 

8.  The  peak  period  of  the  sea  spectrum  (sec). 

9.  The  mean  propagation  direction  of  the  sea  spectrum 
(°  Cartesian). 

10.  The  wave  height  of  the  swell  spectrum  (m) . 

11.  The  peak  period  of  the  swell  spectrum  (sec). 

12.  The  mean  propagation  direction  of  the  swell  spectrum 
(°  Cartesian). 

13.  The  wind  speed  (knots). 

14.  The  wind  direction  (*  Cartesian). 

Parameter  File 

83.  The  Parameter  File  is  created  by  the  General  File  Building  routine. 
The  values  in  the  parameter  file  are  used  to  dimension  variables  in  SHALWV. 

The  SHALWV  program  uses  the  Fortran  command  "INCLUDE"  to  include  the  file 
within  the  program  during  compilation.  The  file  contains  a  FORTRAN  "PARAME¬ 
TER"  statement.  The  variables  in  the  "PARAMETER"  statement  are  defined  as: 

IDMN  -  Number  of  columns  in  the  computational  grid. 

JDMN  -  Number  of  rows  in  the  computational  grid. 

IF  -  Number  of  spectral  frequency  bands . 

IA  -  Number  of  spectral  direction  bands. 

KSST  -  Number  of  water  points  within  the  grid. 

(The  number  of  water  points  is  calculated  during  the  General 
File  Building  Routine  based  on  the  number  of  ones  (1)  in  the 
LAND/WATER  matrix.) 

MKST  -  Number  of  shallow-water  points  within  the  grid. 

(The  number  of  shallow-water  points  is  calculated  during  the 
General  File  Building  Routine  based  on  the  number  of  points 
in  the  grid  where  the  depth- to-wavelength  ratio  is  less  than 
one -half  (1/2). 

NBPS  -  Largest  number  of  input  or  output  boundary  condition 
points . 

NDIF  -  Number  of  diffraction  points. 

Main  File  Name  File 

84.  The  Main  File  Name  File  contains  the  names  of  the  General  Input 
File,  the  Bathymetry  File,  and  the  Sheltering  File.  It  also  provides  parame¬ 
ter  values  indicating  the  SHALWV  process  option,  the  input/output  boundary 
condition  option,  the  warm-start  /  cold-start  option,  as  well  as  estimates  of 
how  much  time  and  memory  SHALWV  will  demand  from  the  computer  for  the  speci¬ 
fied  application.  The  format  for  the  Main  File  Name  File  is  provided. 
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A.  RECORD  1,  Free  Format. 

Field  1  -  Process  Option  (Question  GF-2,  Part  IV). 
fe.  RECORD  2,  Free  Format. 

Field  1  -  General  Input  File  Name. 

c.  RECORD  3,  Free  Format. 

Field  1  -  Bathymetry  Data  File  Name. 

d.  RECORD  4,  Free  Format. 

Field  1  -  Sheltering  Data  File  Name. 

e.  RECORD  5,  Free  Format. 

Field  1  -  Boundary  condition  option  number.  (See  question  GF 
27  in  Part  IV) 

Field  2  -  Start-up  Option  number.  (See  question  GF26  in 
Part  IV) 

f.  RECORD  6,  Free  Format. 

Field  1  -  Estimate  of  CPU  time  for  simulation  in  seconds. 
Field  2  -  Estimate  of  core  storage  for  simulation. 

Wind  File  Name  File 

85 .  The  Wind  File  Name  File  is  created  by  the  Wind  File  Building 
routine  and  contains  the  name  of  the  wind- field  file  to  be  used  by  SHALWV. 

The  format  for  the  Wind  File  Name  File  is  provided  below. 

RECORD  1,  Free  Format. 

Field  1  -  Wind  Input  File  Name. 

Preprocess  File  Name  File 

86.  The  Preprocess  File  Name  File  is  created  when  SHALWV  is  run.  The 
name  of  the  Preprocess  File  generated  by  SHALWV  is  placed  in  the  Preprocess 
File  Name  File.  The  format  for  the  Preprocess  File  Name  File  is  provided 
below. 

RECORD  1,  Free  Format. 

Field  1  -  Preprocess  File  Name. 

Boundary  Condition  File  Name  File 

87 .  The  Boundary  Condition  File  Name  File  contains  the  name  of  the 
Subgrid  Boundary  Condition  File  generated  by  SHALWV.  The  format  for  the 
Boundary  Condition  File  Name  File  is  provided  below. 

RECORD  1,  Free  Format. 

Field  1  -  Boundary  Condition  File  Name. 


7-93 


Warm  Start  File  Name  File 

88.  The  Warm  Start  File  Name  File  contains  the  name  of  the  Warm  Start 
File  generated  by  SHALWV.  The  format  for  the  Warm  Start  File  Name  File  is 
provided  below. 

RECORD  1,  Free  Format. 

Field  1  -  Warm  Start  File  Name. 

Post-Processing  File  Name  File 

89.  The  Post-Processing  File  Name  File  contains  the  names  of  the  data 
output  files  generated  by  SHALWV.  The  files  included  the  Wave  Field  Output 
File,  the  Wave  Characteristic  Output  File,  and  the  Wave  Spectra  File.  The 
format  for  the  Post-Processing  File  Name  File  is  provided  below. 

RECORD  1,  Free  format. 


Field 

1  - 

Name 

of 

the 

" . sea" 

file. 

Field 

2  - 

Name 

of 

the 

" . spe" 

file. 

Field 

3  - 

Name 

of 

the 

" .mtx" 

file. 

(See  Part  IV  for  description.) 

Example  Data  Sets 


SHALWV  Module  example  data  set 

90.  A  description  of  an  example  test  case  for  SHALWV  is  included  here. 
The  example  is  designed  to  provide  a  data  set  with  which  SHALWV  can  be  run, 
allowing  the  users  to  familiarize  themselves  with  the  Spectral  Wave  Modeling 
Module.  The  example  Is  an  idealized  situation  where  a  body  of  water  of 
constant  depth  is  subjected  to  a  constant  wind  with  no  other  forcing  condition 
such  as  incoming  waves.  In  essence,  the  example  provides  an  indication  of 
wind-wave  growth  capabilities  of  the  SHALWV  model.  The  computational  grid  is 
illustrated  in  Figure  7-16. 

91.  The  Instructions  and  data  values  that  follow  should  be  used  to 
conduct  the  example  test  simulation. 

Instructions  and  data  for  example  case 

92.  Building  the  General  Input  File.  The  following  items  are  provided 
in  the  order  in  which  they  will  be  requested. 

a.  Enter  the  SHALWV  module  through  the  CMS  menu. 

b.  Select  "Building  Files"  from  the  main  menu. 

c.  Select  "General  File  Building"  from  the  "Building  Files"  menu. 


7-94 


Winds 


(The  following  data  will  be  requested  by  the  module.  Use  the  provided  data 
only  to  ensure  a  successful  simulation.) 

(1)  Select  either  80-  or  132-character  screen  width  . 

(2)  Select  "preprocess  and  calculate  wave  field"  option. 

(3)  Select  "Not  a  subgrid  run"  option. 

(4)  Number  of  COLUMNS  in  grid  is  15. 

(5)  Number  of  ROWS  in  grid  is  11. 

(6)  Number  of  FREQUENCY  BANDS  is  20. 

(7)  Number  of  direction  ANGLE  BANDS  is  16. 

(8)  Select  "Frequency  Band  Values  computed"  option. 

(9)  Select  "Constant  Water  Depth"  option. 

(10)  Depth  Conversion  Factor  is  1.0. 

(11)  Distance  Between  Grid  Points  is  50  km. 

(12)  Refraction  Scale  Factor  is  10. 

(13)  Computational  Time-Step  is  900  sec. 

(14)  First  Frequency  Band  Value  is  0.03  Hz. 

(15)  Frequency  Band  Value  Interval  is  0.02  Hz. 

(16)  Constant  Water  Depth  is  1,000  m. 

(17)  Select  "Generate  Test  Matrix"  option  for  Land/Water  Matrix. 

(18)  Select  "Cold  Start/No  Save"  option. 

(19)  Select  "No  Input  Boundary  Conditions"  option. 

(20)  Select  "Constant  Winds"  option. 

(21)  Select  "No  Bottom  Effects"  option. 
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(22)  Number  of  Time  Steps  Between  Output  is  4. 

(23)  Number  of  Hours  Between  Wind  Inputs  is  1. 

(24)  Number  of  Wind  Inputs  is  48. 

(25)  Number  of  Special  Output  Locations  is  4. 

(26)  Special  Output  Locations  are 

b.  6  9,  6  12,  6  15,  6 

(27)  Select  "No  Diffraction"  option. 

(28)  Select  "No  Sheltering"  option. 

<1.  At  this  point,  all  of  the  General  Input  File  data  have  been 
entered.  You  may,  at  your  discretion,  press  RETURN  as  needed 
to  work  through  the  summary  that  follows  at  the  data  input 
session.  You  will  then  be  returned  to  the  "Building  Files" 
menu. 

93.  Building  the  Wind  Field  File.  Select  "Build  Wind  Field  File"  from 
the  "Building  Files"  menu.  (The  following  data  will  be  requested  by  the 
module.  Use  the  provided  data  only  to  ensure  a  successful  simulation.) 

a.  Answer  "yes"  when  asked  whether  General  Input  File  Building  has 
been  run.  (It  was  done  in  Step  1.) 

b.  The  "Wind  Speed  Convention"  option  is  1  (for  meters/second). 

£.  The  "Wind  Direction  Convention"  option  is  1  (for  Cartesian, 
toward  which  the  winds  blow) . 

d.  Wind  Speed  Value  is  20  m/sec  (constant). 

£.  Wind  Direction  Value  is  0  deg  (constant). 

£.  Output  file  name  is  WINDS. 

94.  The  module  will  then  return  you  to  the  "Building  Files"  menu. 

Press  "0”  to  return  to  the  main  module  menu. 

Running  the  SHALWV  program 

3.  Select  "Run  Programs"  from  the  "Main  Menu". 

fe.  Select  "Run  SHALWV"  from  the  "Run  Programs"  menu  and  provide  an 
output  file  name  called  EXAMPLE  when  prompted  to  do  so. 

£.  At  this  point,  the  SHALWV  program  is  submitted  to  the  CRAY  Y-MP 
batch  queues  for  execution.  This  particular  application 
requires  only  about  1  min  of  the  CRAY  Y-MP's  CPU  time  to 
compile  and  link  the  SHALWV  program  and  to  execute  the  simula¬ 
tion. 

d.  Press  RETURN  until  the  "Run  Programs"  menu  appears.  Press  "0" 
to  return  to  the  "Main  Menu" . 

Graphically  view  the  results 

3.  At  the  "Main  Menu",  select  "Plot/Print  Results"  to  graphically 
view  the  results  of  this  example  case. 

fe.  At  the  "Plot/Print  Menu"  select  "Graphics". 
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£.  At  the  "Plot  Options"  menu,  select  the  type  of  plot  to  view. 
(The  bathymetric  contour  plot  is  not  recommended  since  a 
constant  depth  was  used  for  the  simulation.)  The  following 
provides  information  for  creating  any  of  the  available  plots . 

Wave  field  plots 

a.  Select  "Wave  Field  Plot"  from  the  "Graphics"  menu. 

b.  Answer  "no"  to  the  question  about  Customizing  your  plot. 

c.  Select  either  "Wave  Height  Contours,"  "Wave  Period  Contours," 
or  "Wave  Direction  Vectors." 

4.  Select  the  dates  for  which  plots  should  be  created.  You  must 
select  the  starting  date  number,  the  ending  date  number,  and 
the  interval  between  dates.  If  you  want  only  one  plot,  enter 
the  appropriate  date  number  as  both  the  starting  and  ending 
date  numbers. 

e.  After  a  brief  pause,  a  message  will  be  issued  indicating  that 
the  metafile  containing  the  plots  has  been  generated.  Press 
RETURN,  and  select  the  appropriate  device-type  for  viewing  the 
plots  on  your  terminal.  At  the  "Enter  Plot  Directives"  prompt, 
enter  a  RETURN.  The  first  plot  will  be  drawn  on  your  screen. 
When  you  wish  to  proceed  to  the  next  plot,  press  a  RETURN. 
Figures  7-17  through  7-19  contain  plots  of  the  wave  height  and 
period  contours  and  wave  direction  vectors  for  the  36th  hour  of 
the  48 -hr  simulation. 

NOTES : 

(1)  If  the  dates  selected  for  plotting  are  early  in  the  simu¬ 
lation,  there  may  be  little  information  presented  in  the 
plot  because  the  wave  conditions  have  not  had  sufficient 
time  to  develop.  Plots  for  dates  late  in  the  simulation 
will  have  more  information,  since  waves  are  approaching 
fully  developed  conditions. 

(2)  While  evaluating  the  plots,  note  that  the  wind  is  blowing 
from  left  to  right  across  the  grid  (0  deg)  and  therefore 
wave  conditions  increase  in  the  same  direction. 

Spectral  Plots 

a.  Select  "Spectral  Plots"  option  from  the  "Graphics"  menu. 

b.  Answer  "no"  to  the  question  about  Customizing  your  plot. 

c.  Select  either  "One-Dimensional  Spectra"  or  "Two-Dimensional 
Spectra . " 

d.  Select  the  station  at  which  the  spectral  information  is  de¬ 
sired.  Figure  16  shows  the  locations  of  the  stations  on  the 
computational  grid. 

e.  Select  the  dates  for  which  plots  should  be  created.  You  must 
select  the  starting  date  number,  the  ending  date  number,  and 
the  interval  between  dates.  If  you  want  only  one  plot,  enter 
the  appropriate  date  number  as  both  the  starting  and  ending 
date  numbers . 
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Wave  Height  Contours 


Figure  7-17.  Wave  height  contours  for  the  36th  hr 
of  the  example  simulation 


f.  After  a  brief  pause,  a  message  will  be  issued  indicating  that 
the  metafile  containing  the  plots  has  been  generated.  Press 
RETURN,  and  select  the  appropriate  device-type  for  viewing  the 
plots  on  your  terminal.  At  the  "Enter  Plot  Directives"  prompt, 
enter  a  RETURN.  If  one-dimensional  spectra  are  being  plotted, 
all  of  the  spectra  (one  for  each  date  selected)  will  be  plotted 
on  the  same  graph.  If  two-dimensional  spectra  are  being  plot¬ 
ted,  each  spectrum  is  presented  in  contour  form  with  only  one 
spectrum  per  plot.  When  you  wish  to  proceed  to  the  next  plot, 
press  a  RETURN.  Figures  20  and  21  contain  plots  of  the  one- 
and  two-dimensional  spectra  computed  at  station  3  (location  12, 
6)  for  the  36th  hour  of  the  48 -hr  simulation. 

Wave/Wind  History  Plots 

a.  Select  "Wave/Wind  History  Plot"  from  the  "Graphics"  menu. 

b.  Answer  "no"  to  the  question  about  Customizing  your  plot. 

£.  Select  "Wave  History  Plots"  or  "Wind  History  Plots." 
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Wave  Period  Contours 


Figure  7-18.  Wave  period  contours  for  the  36th  hr 
of  the  example  simulation 

d.  If  "Wave  History  Plots"  is  selected,  you  will  be  required  to 
specify  which  wave  conditions  should  be  plotted.  Your  choices 
include  the  wave  conditions  for  both  the  wind- sea  and  swell 
waves  combined,  wave  conditions  for  just  the  wind-sea  portion 
of  the  wave  field,  and  the  wave  conditions  for  just  the  swell 
portion  of  the  wave  field.  Enter  "1  2  3"  to  view  all  three 
types  of  wave  conditions  simultaneously. 

e.  After  a  brief  pause,  a  message  will  be  issued  indicating  that 
the  metafile  containing  the  plots  has  been  generated.  Press 
RETURN,  and  select  the  appropriate  device -type  for  viewing  the 
plots  on  your  terminal.  At  the  "Enter  Plot  Directives"  prompt, 
enter  a  RETURN.  When  you  are  through  viewing  the  plot,  you  may 
exit  by  pressing  RETURN.  Figure  22  contains  plots  of  the 
history  of  wave  height,  period,  and  direction  computed  at 
station  3  (location  12,  6)  for  the  36th  hour  of  the  48-hr 
simulation. 
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Figure  7-19.  Wave  direction  vectors  for  the  36th  hr 
of  the  example  simulation 
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Figure  7-20.  One-dimensional  wave  energy  spectrum  computed 
at  station  3  for  the  36th  hr  of  the  example  simulation 
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1.  Numerical  models  consist  of  one  or  more  mathematical  equations  that 
define  or  describe  the  physical  processes  of  a  system.  The  equations  often 
contain  partial  derivatives  that  define  how  flow  field  variable.';  change  with 
respect  to  time  and/or  space.  The  models  use  mathematical  (finite  difference 
or  finite  element)  approximations  to  represent  these  continuous  equations  at 
discrete  locations.  The  continuum  is,  therefore,  represented  by  discrete 
points  in  time  and  space.  Hence,  a  computational  grid  is  employed  by  the 
model  to  define  the  flow  field  at  discrete  points. 

2.  A  grid  is  composed  of  a  lattice  network  of  cells,  and  each  cell  has 
certain  flow  field  parameters  associated  with  it.  In  the  case  of  the  WES 
Implicit  Flooding  Model  (WIFM) ,  these  parameters  include  water  depths,  water 
and  wind  velocities,  and  water  surface  elevations.  A  model  is  expected  to 
accurately  predict  flow  parameters  in  the  domain  of  interest,  and  model 
accuracy  is  dependent,  in  part,  on  how  well  the  specified  grid  resolution 
represents  the  spatial  domain  and  the  flow  field.  The  methodology  used  to 
create  computational  grids  for  models  residing  in  the  Coastal  Modeling  System 
(CMS)  is  presented  here. 

3.  At  the  present  time  this  package  has  the  capability  to  generate 
grids  in  a  stretched  rectangular  coordinate  system.  Uniformly  spaced  grids, 
which  are  a  subset  of  this  group,  can  also  be  generated.  The  programs 
contained  in  this  package  are  listed  in  Table  A-l. 


Table  A-l 
CMSGRID  Components 

Pro&raiB  _ Description 


MAPIT 

DRAWIT 

LISTIT 


Stretch  rectangular  coordinate  grid  generator. 
Graphical  program  to  plot  grids  generated  by  MAPIT. 
Program  to  print  grid  coordinate  points. 


Computational  Technique  of  Program  MAPIT 


4.  Program  MAPIT  is  designed  to  calculate  the  mapping  function  that 
relates  a  variably  spaced  grid  in  prototype  space  to  a  uniformly  spaced  grid 
in  computational  space.  The  function  defining  the  mapping  from  prototype 
space  (x)  to  computational  space  (a)  is: 

x  =*  a  +  bae 


where 

x  -  actual  mapping  distance  from  the  origin 

a  —  distance  from  the  origin  in  computational  space  (which  can  also 

be  thought  of  as  the  cell  index  number  assuming  a  constant 
computational  grid  cell  size  of  1.0) 

a,  b,  c  -  coefficients  calculated  by  the  program  (Figure  A-l) 

The  entire  prototype  space  to  be  mapped  can  be  separated  into  user- specified 
regions  of  arbitrary  length  defined  by  end  points  Xj,  x2...xn  (for  n-1 
regions),  and  the  mapping  function  is  applied  to  each  region.  Values  of  the 
three  coefficients  are  thus  derived  for  each  of  the  n-1  regions.  The  values 
of  a  ,  b  ,  and  c  are  determined  by  requiring  continuity  of  both  the 
function,  x  ,  and  its  first  derivative  from  region  to  region.  This 
constraint  provides  a  smoothly  varying  grid. 

5.  For  any  region  the  following  relationships  must  be  satisfied: 

x,  =  a  +  bact  (a2) 

*  ■  (£ ),  *  **r*  <A3) 


i  i  + 1  i  +  2  i  +  3 


Figure  A-l  Variably  spaced  grid. 
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where  the  subscripts  i  and  i+1  refer  to  the  beginning  and  ending  points  of 
the  region.  The  three  coefficients  (a,  b,  c)  for  each  region  are  derived  from 
four  nonlinear  equations,  over -constrained  by  the  known  values  of  xt  ,  xi+1  , 
x'i  .  x't+i  .  at  .  and  a1+1  . 

6.  In  practice,  the  solution  procedure  of  MAPIT  operates  somewhat 

differently.  The  algorithm  assumes  that  regions  are  mapped  in  a  sequential 
order  from  1  to  (n-2),  and  that  the  a's  are  always  positive  integers.  For 
any  given  region,  the  values  of  xL  ,  x'i  ,  and  are  known  from  the 

computations  for  the  previous  region.  (The  user  specifies  these  values  for 
the  first  region.)  The  user  specifies  the  distance  to  the  far  end  of  the 
region  (xi+1)  and  the  cell  size  at  the  far  end  of  the  region  (x  'm)  »  while  the 
number  of  cells  (ai+1)  is  computed  by  the  program  in  a  preliminary 
computation.  It  should  be  noted  that  the  value  (a1+1  -  a±)  gives  the  number  of 
grid  cells  that  lie  between  the  endpoints  of  a  region. 

7.  Providing  that  a  ,  b  ,  and  c  have  been  determined,  an  optimal 
value  of  q1+1  can  be  chosen,  such  that  the  difference  between  the  desired 
value  of  x1+1  and  that  calculated  from  Equation  A4  can  be  minimized.  The 
three  coefficients,  derived  from  Equations  A2  through  A5,  are  presented  below: 


.  .  log  (xi/xu) 
log  (at/a l4l) 

(AS) 

a  =  x,  -  ba<  =  x,-  -  — — 

1  1  c 

(A7) 

b  =  {xt  -  a)  /a? 

(A8) 

8.  This  preliminary  calculation  in  MAPIT  starts  by  assuming  an  ai+1 
value  greater  than  a*  .  The  values  of  a  ,  b  ,  and  c  are  then  determined 
from  Equations  A6  through  A8,  and  a  calculated  value  of  xm  is  obtained 
from  Equation  A4.  This  computed  value  is  compared  with  the  desired  value  of 
x1+1  ;  the  value  of  ai+1  is  incremented  or  decremented;  and  the  procedure  is 
repeated  until  the  calculated  x1+1  value  becomes  approximately  equal  to  the 
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desired  value.  The  program  warns  the  user  if  the  region  is  too  small  to  fit  a 
single  cell,  or  if  more  than  500  cells  appear  in  any  one  region.  The  non¬ 
linear  system  of  equations  are  solved  iteratively  to  assure  that  a  convergent 
value  of  the  exponent  c  is  generated.  Two  procedures  are  used  in  MAPIT,  and 
they  are  expressed  mathematically  below: 


log 
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Procedure  II 
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where  k  is  the  iteration  counter.  These  two  relationships  are  derived  from 
Equations  A2  through  A5.  Both  equations  contain  one  zero  root,  as  well  as  the 
root  of  interest.  The  roots  of  interest  are  then  averaged,  and  the  average 
value  of  c  is  used  for  computing  a  and  b  .  Procedure  I  also  has  an 
asymptote : 

c  =  ~aix;  (aid 

*  *  *1 

9.  Both  procedures  are  solved  using  the  Newton-Raphson  method  and  are 
compared  with  each  other.  All  four  roots  of  the  two  equations  are  found  and 
checked  in  order  to  find  problems  with  pathological  solutions  for  c  and  poor 
convergence  in  iteration.  Following  the  solution  for  c  ,  the  values  of  a 
and  b  are  found  from  Equations  A7  and  A8 .  It  should  be  noted  that  x'i  +  l 
is  never  used  in  the  calculations  of  the  three  coefficients  computed  from 
Equations  A7  through  A10.  The  three  coefficients  are  computed  using 
previously  known  values  of  c  and  the  given  xi+1  .  The  values  of  the 
coefficients  satisfy  the  relationships  of  Equations  A2  through  A4,  but  not 
Equation  A5 .  MAPIT  recalculates  x'1+1  from  Equation  A5  to  complete  the 
problem,  and  it  displays  the  results  for  the  region  to  the  user.  The  user 
then  has  the  option  to  continue  to  the  next  region,  try  the  same  region  again 
with  different  inputs,  or  back  up  to  a  previous  region.  If  the  user  does  not 
want  the  value  of  x'1+1  recalculated  by  the  program,  but  requires  specific 


values  of  both  x1+1  and  x'i+i  ,  then  the  code  can  calculate  coefficients 
for  two  regions  at  once.  The  values  of  x  ,  the  derivative,  and  alpha  of  the 
partition  point  between  the  two  regions  are  all  calculated  by  the  code.  The 
equations  for  two  adjacent  regions  are: 


xi  -  at  M? 

(A12) 

*i.i  -  +  Mill 

(A13) 

*i.i  •  *2  +  b2a% 

(A14) 
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xi  =  biC^Ui1 

(A16) 

*1.1  =  Ml“i‘l 

(A17) 
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*i.i  *  b2c2aCjV2 

(A19) 

10.  If  a  value  for  a1+1  is  assumed,  then  this  system  of  equations 
becomes  eight  equations  with  six  unknown  coefficients,  xt  ,  xi+1  ,  xi+2  , 
x'i  ,  x'i+1  ,  x'i+2  .  Equations  A12  through  Al9  can  be  algebraically  reduced 
to  two  equations  in  the  unknowns  of  C;  and  c2  : 
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These  two  equations  can  be  manipulated  to  yield  two  pairs  of  equations  in  cx 
and  c2  : 
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where  the  k  superscript  is  an  iteration  counter.  The  coefficients  Cx  and 
c2  can  be  calculated  from  either  of  the  above  pairs  of  equations,  and  the 
remaining  unknowns  can  be  found  by  substitution. 

11.  The  actual  algorithm  for  the  double  region  routine  is  rather 
complicated  due  to  the  nature  of  Equations  A22  through  A24.  Equation  A21 
represents  a  straight  line  with  a  negative  slope  in  Ci  -  c2  space,  whereas 
Equations  A23  through  A25  each  have  one  asymptote  for  their  dependent 
variable.  These  asymptotes  are  given  by: 


log 

c* 

1  +  - (*i.2  -  Xj) 

*iX'i 

i°g  !«(., /«*) 

(A26) 


for  Equation  A23,  and 


log 

c2 

1  ♦  - (xi  -  x.-.j) 

log  («m/«i.2) 

(A27) 


for  Equation  A25 . 

12.  The  plot  of  Equations  A21  through  A27  is  shown  in  Figure  A-2 
together  with  the  two  possible  solution  paths  suggested  by  the  equation  pairs 
of  Equations  A22  and  A23,  and  A24  and  A25.  The  major  difficulties  in  the 
solution  algorithm  are  choosing  the  appropriate  starting  values  of  cx  and 
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c2  and  determining  which  of  the  tvo  equation  pairs  yield  a  convergent 
solution.  Since  the  asymptotic  values  of  c2  and  c2  can  be  determined  from 
Equations  A26  and  A27,  starting  values  are  arbitrarily  chosen  as  a  specified 
percentage  of  these  asymptotic  values. 

13.  In  attempting  to  find  a  convergent  solution,  a  first  estimate  is 
obtained  from  Equations  A22  and  A23.  If  the  value  of  c2  becomes  zero, 
Equations  A24  and  A25  are  used  with  the  starting  values.  Should  the  value  of 
Ci  also  become  zero,  then  the  starting  point  lies  too  close  to  the 
asymptotes.  A  new  starting  point  closer  to  the  origin  is  then  defined,  and 
the  whole  calculation  cycle  is  repeated.  Any  time  both  equation  sets  are 
satisfied  by  a  zero  solution  or  fail  to  converge  within  a  set  number  of 
iterations,  the  starting  point  is  redefined,  and  the  iteration  procedure  is 
repeated.  Calculations  cease  after  10  different  starting  points  have  been 
tried,  and  the  user  is  warned  about  nonconvergence  of  the  input  values. 

14.  It  must  be  pointed  out  that  not  every  possible  set  of  inputs  for 
the  double  region  routine  will  yield  a  solution.  The  algorithm  is  coded  to 
make  a  reasonable  attempt  to  find  a  solution;  however,  the  user  is  warned 
about  nonconvergent  cases  or  pathological  functions.  The  procedure 

also  attempts  to  resolve  other  problems,  such  as  attempts  to  take  the 
logarithm  of  negative  numbers. 


Figure  A- 2  Graphic  solution  of  double  region  procedure 
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15.  Three  basic  steps  are  required  to  generate  stretched  rectilinear 


grids : 

a.  Defining  the  grid  orientation  and  limits. 

b.  Determining  the  grid  cell  resolution  in  the  seaward  direction. 

c.  Determining  the  grid  cell  resolution  in  the  longshore 
direction. 

16.  The  following  discussion  presents  guidelines  for  the  above  topics; 
however,  due  to  the  complexity  of  coastal  regions,  these  guidelines  will  not 
be  applicable  to  every  situation  encountered.  Hence,  knowledge  of  the 
capabilities  and  limitations  of  the  model  intended  to  be  used  is  needed  in 
developing  computational  grids. 

Grid  orientation  and  limits 

17.  The  user  should  select  a  detailed  chart  or  map  of  the  study  area 
with  sufficient  resolution  of  the  coastline  and  hydraulic  features  to  resolve 
such  features  as  sharp  depth  gradients  or  reefs.  Maps  constructed  from  a 
Mercator  projection  should  be  used,  especially  if  multiple  maps  are  needed  to 
define  the  study  area.  Mercator  projection  preserves  the  angle  relationship, 
allowing  the  grid  to  be  transferred  from  one  scale  to  another  without 
distortion. 

18.  The  user  should  overlay  the  map  with  a  sheet  of  Mylar  or  tracing 
paper  and  draw  a  line  on  the  Mylar  that  best  describes  the  coastline 
orientation  along  the  reach  that  is  of  primary  interest.  A  line  perpendicular 
to  any  inlet  or  channel  of  interest  should  be  drawn.  These  lines  provide 
guidance  concerning  orientation  of  grid  axes. 

19.  The  x  and  y  axes  can  be  oriented  arbitrarily  as  long  as  a  right- 
handed  coordinate  system  is  used.  However,  the  choice  of  alignment  for  the 
grid  axes  is  extremely  important,  especially  when  the  geometric  features  of 
the  area  to  be  modeled  are  complex.  Because  the  modeled  area  must  be 
represented  with  rectangular  cells,  the  user  should  keep  in  mind  that 
minimizing  any  stair-stepped  representation  of  shorelines,  structures,  and/or 
major  channels  will  produce  the  most  suitable  grid. 

20.  For  WIFM  simulations,  the  user  should  estimate  the  maximum  flood 
height  resulting  from  extreme  tidal-  or  storm- induced  water  levels  that  will 
be  simulated  by  the  model.  This  estimate  can  usually  be  supplied  from 

I 


historical  records;  if  not,  approximate  values  can  be  computed  by  the 
procedures  presented  in  EM  1110*2*1412.  Next,  a  freeboard  of  at  least  3  ft 
should  be  added  to  the  maximum  flood  height.  The  user  then  locates  points  or 
line  segments  delineating  the  extent  of  flooding  and  uses  these  points  to 
define  the  boundaries  of  the  grid.  Topographic  features  that  prevent  flooding 
should  also  be  considered  when  defining  the  model  domain. 

21.  For  a  storm  surge  simulation,  the  seaward  boundary  should  extend  to 
the  seaward  edge  of  the  Continental  Shelf.  Therefore,  the  user  should  draw 
another  line  on  the  Mylar  parallel  to  the  reference  line,  at  the  Continental 
Shelf.  The  adjacent,  or  lateral,  boundaries  must  be  placed  far  enough  from 
the  area  of  interest  so  that  inaccuracies  caused  by  uncertainties  in  the 
boundary  values  specified  in  the  model  are  minimized.  As  a  rule  of  thumb,  the 
grid  should  extend  laterally  from  the  area  of  interest  in  each  direction,  a 
distance  of  at  least  1.5  to  2.0  times  the  distance  from  the  coastline  to  the 
shelf. 

22.  For  a  tidal  circulation  investigation,  the  grid  limits  are 
dependent  on  the  size  and  shape  of  the  area  of  interest  and  where  data  are 
available  for  establishing  a  proper  boundary  condition.  For  example,  back-bay 
areas  in  the  model  may  be  influenced  by  river/channel  systems.  The  model  grid 
should  extend  into  such  systems  to  a  point  where  the  water  level,  flow  rate, 
or  velocity  have  been  measured  and  can  be  used  to  establish  a  boundary 
condition.  In  the  open  coast  area,  the  seaward  and  lateral  open  boundaries 
should  extend  far  enough  from  the  area  of  interest  so  that  computations  in  the 
area  of  interest  are  not  significantly  affected  by  inaccuracies  in  boundary 
specification.  Again,  data  (usually  water  level  measurements  or  tidal 
constituents)  should  be  available  in  the  open  coastal  area  to  be  used  as 
boundary  conditions. 

23.  Many  WIFM  applications  involve  consideration  of  tidal  hydrodynamics 
at  structured  inlets.  A  general  rule  of  thumb  is  to  locate  open  water 
boundaries  a  distance  from  the  inlet  equivalent  to  5  times  the  length  of  the 
inlet  structure. 

24.  In  storm  or  tidal  investigations,  a  grid  sensitivity  study  can  be 
performed.  This  type  of  test  is  usually  performed  to  minimize  the  size  of  the 
open  ocean  portion  of  a  grid.  The  test  is  done  by  first  developing  a  grid 
with  limits  exceeding  the  specifications  mentioned  in  earlier  paragraphs. 
Having  made  good  engineering  estimates  for  other  model  input  parameters 
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(depth,  friction,  etc.),  a  test  is  run  with  the  large  grid.  The  test  is  then 
repeated  after  reducing  the  grid  size  in  both  seaward  and  lateral  directions. 
The  results  in  the  area  of  interest  are  checked  to  determine  the  impact  of  the 
new  boundary  location. 

Seaward.  grAjLs.s,U,-r?g9lvvt9n 

25.  A  profile  of  the  seabed  is  drawn  on  a  separate  sheet  of  Mylar, 
running  from  the  onshore  boundary  to  the  seaward  boundary.  The  bottom  profile 
is  simplified  by  drawing  straight  lines  that  represent  regions  having 
approximately  the  same  slope.  (Normally  four  to  eight  regions  are 
sufficient.)  A  separate  stretching  function  (Equation  A2)  should  be  applied 
to  each  region  in  order  to  generate  grid  cells  that  adequately  define  the 
area.  As  a  first  attempt  at  creating  a  grid,  a  constant  value  of  the  ratio, 

A x/L  ,  (where  Ax  is  the  grid  cell  size  and  L  is  the  wavelength)  should  be 
maintained. 

26.  Cell  dimensions  are  first  chosen  for  the  area  of  interest.  In  this 
region  the  cells  should  be  square,  or  nearly  square,  and  have  a  greater 
resolution  (i.e.,  more  cells  per  unit  area)  than  in  the  remaining  regions. 

Cell  sizes  must  be  small  enough  so  that  the  hydraulic  features  are  resolved. 
However,  computer  costs  for  executing  the  model  will  be  prohibitive  if  the 
grid  has  too  many  cells  or  if  the  minimum  cell  size  forces  the  choice  of  a 
very  small  time -step  according  to  the  Courant  stability  constraint. 

27.  Seaward  of  the  area  of  interest,  cell  dimensions  can  usually  be 
increased.  This  is  performed  by  smoothly  increasing  cell  dimension  sizes  over 
the  distance  defined  by  the  slope  region.  The  first  cell  in  a  region  should 
not  increase  by  more  than  25  percent  of  the  size  of  the  last  cell  in  the 
previous  region.  The  largest  cell  in  the  grid,  normally  located  at  the 
seaward  boundary,  should  not  be  greater  than  20  times  the  size  of  the  smallest 
cell  in  the  grid. 

28.  Grid  sizes  may  increase  in  the  inland  direction  away  from  the  area 
of  interest.  However,  care  should  be  taken  to  sufficiently  resolve  the  inland 
water/land  system.  Proper  resolution  will  ensure  the  flooding  and  drying 
algorithm  in  model  WIFM  can  be  accurately  applied  to  this  area. 

Longshore  grid  cell  resolution 

29.  Longshore  grid  cell  resolution  is  determined  from  the  variability 
of  the  coastline  as  opposed  to  bed  slope  in  the  seaward  direction.  However, 
the  concepts  of  increasing  the  resolution  in  areas  of  rapid  change  are  the 
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same.  Greater  resolution  is  needed  in  areas  where  the  landforms  or  other 
hydraulic  features  have  significant  influence  on  hydrodynamics  in  the  region 
of  interest.  Grid  lines  should  be  placed  to  match  the  orientation  of  these 
features,  where  possible. 

30.  As  a  practical  guideline,  there  are  two  basic  methods  for  ensuring 
good  grid  resolution  of  small  hydraulic  features  such  as  inlets.  The  first 
method  is  to  put  a  partition  in  the  middle  of  the  inlet.  If  a  suitably  small 
cell  width  is  chosen  for  this  partition,  with  larger  cell  sizes  at  the  two 
nearest  endpoints,  then  the  inlet  will  be  modeled  with  a  cell  group  smallest 
in  the  center  of  the  inlet  and  largest  at  its  edges.  If  a  relatively  constant 
cell  size  is  desired  across  an  inlet,  then  it  is  best  to  place  a  partition 
point  at  each  edge  of  the  inlet,  so  that  the  inlet  becomes  one  region.  Equal 
cell  widths  can  be  defined  at  the  end  points,  resulting  in  nearly  constant 
cell  widths  across  the  inlet.  This  method  has  the  advantages  of  placing 
partition  lines  at  the  land-water  boundaries  of  the  inlet  and  ensuring  a 
specific  grid  resolution;  however,  this  often  generates  a  larger  number  of 
cells  over  the  entire  grid  because  the  fine  resolution  in  the  inlet  will  be 
"carried"  into  the  open  ocean  area. 

31.  For  featureless  terrain  bounded  by  high- resolution  regions,  two 
partitioning  methods  can  be  used  to  minimize  the  number  of  required  grid 
cells.  One  method  divides  the  area  into  two  regions,  containing  partitions 
with  small  cells  in  the  required  areas.  The  second  method  divides  the  area 
into  three  regions,  with  small  cells  at  the  outer  partitions  and  large  cells 
at  the  two  inner  partitions.  This  method  creates  large  cells  in  the  middle 
region  and  rapid  changes  in  cell  size  in  the  two  outer  regions  of  the  area. 

The  method  that  produces  the  minimum  number  of  cells  is  preferable. 

Additional  considerations  for  grid  generation 

32.  As  a  practical  guideline,  channels  should  be  oriented  approximately 
parallel  to  the  grid  axes  to  avoid  stair-stepping.  Orientation  at  a  45 -degree 
angle  for  square  grid  cells  would  maximize  stair-stepping  and  should  be 
avoided.  Another  method  of  avoiding  stair-stepping  is  to  alter  the 
orientation  of  water  bodies  in  nonsensitive  areas  while  preserving  storage 
capacity,  as  shown  in  Figure  A- 3. 

33.  The  ratio  of  the  cell  size  in  the  longshore  direction  to  the  cell 
size  in  the  on-offshore  direction,  or  aspect  ratio,  should  also  be  examined 
and  considered  when  generating  a  grid.  For  example,  model  RCPWAVE  requires 
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large  aspect  ratios  to  resolve  large  input  wave  angles .  An  aspect  ratio  of 
two  is  typically  used  for  RCPWAVE  applications.  On  the  other  hand, 
hydrodynamic  models,  such  as  WIFM  and  CLHYD,  produce  most  accurate  results 
with  an  aspect  ratio  of  1,  indicating  "square"  grid  cells.  An  aspect  ratio 
within  the  range  0.2  and  5  produces  adequate  results  in  the  area  of  interest 
and  the  aspect  ratio  can  be  as  much  as  20  away  from  the  area  of  interest. 

34.  Lastly,  the  user  should  be  aware  of  the  implications  of  two 
stability  criteria  on  grid  generation,  the  Courant  condition  and  the  diffusion 
number.  The  Courant  condition 


ct 


Ax/ A  t 


defines  the  maximum  permissible  time-step  size  for  a  given  value  of  Cz  , 
where  g  is  the  gravitational  acceleration,  Ax  is  the  dimension  of  the 
smallest  grid  cell  within  the  computational  domain,  H  is  the  depth  at  that 
cell,  and  At  is  the  time-step  size.  Therefore,  a  fine-resolution  grid  will 
require  a  small  time-step  size  and  a  large  number  of  time-steps  for  a  given 
simulation  length,  which  can  become  computation  prohibitive.  The  Courant 
number,  Cz  ,  is  ideally  less  than  0.5,  but  results  can  be  obtained  for  Cz 
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less  than  7.0.  It  is  recommended  that  a  Courant  number  on  the  order  of  1.0  to 
7.0  be  used  for  VIFM  and  CLHYD  applications. 

35.  The  second  stability  criterion,  the  advection  limit,  is  the  maximum 
allowable  time-step,  At  ,  based  on  the  time  for  a  particle  to  travel  through 
the  smallest  grid  cell: 


At  s 


Ax 

U 


or 


Ay 

V 


where  Ax  and  A y  are  the  smallest  grid  cells  in  the  x-  and  y-  directions, 
respectively  and  U  and  V  are  the  particle  velocities  in  the  x-  and 
y-directions ,  respectively.  Experienced  modelers  usually  select  a  time-step 
somewhat  "less  than"  this  limit,  rather  than  "equal  to"  the  limiting  value. 


Program  MAPIT 

36.  Program  MAPIT  generates  computational  grids  for  the  models  residing 
in  CMS.  Presently,  this  program  will  generate  only  grids  having  stretched  or 
uniform  rectilinear  coordinate  systems  (i.e.,  models  WIFM,  SPH,  RCPWAVE, 

CLHYD,  and  SHALWV) .  Guidelines  for  developing  a  stretched  rectilinear  grid 
have  been  discussed  previously  in  this  Appendix. 

37.  Computer  costs  incurred  in  executing  the  models  can  be  reduced  by 
selecting  the  x-direction  axis  so  that  it  contains  more  grid  cells  than  the  y- 
axis.  Cost  reduction  is  related  to  the  manner  in  which  two-dimensional  arrays 
are  stored.  The  x-  and  y-direction  grid  axes  can  be  computed,  or  mapped,  in 
either  order;  however,  the  following  requirements  must  be  met: 

a.  Each  region  must  be  mapped  in  sequence,  starting  at  the  axis 
origin. 

b.  Distances  are  measured  from  the  axis  origin.  A  common  choice 
for  distance  units  is  map  inches  so  a  map  overlay  can  be 
created. 

c.  Grid  cells  are  numbered  sequentially,  with  the  first  cell  at 
the  axis  origin. 

Program  input  data 

38.  Program  MAPIT  is  executed  interactively.  Hence,  the  program  will 
prompt  the  user  for  the  input  data.  MAPIT  responses  require  capital  letters. 
An  instruction  menu,  listing  the  valid  user  commands  and  corresponding 
variables,  is  presented  in  Table  A- 2. 
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Command 

? 

SINGLE 


DOUBLE 


BACKUP 

SUMMARY 

ENDDIR 

DEBUG 


Table  A- 2 

Instruction  Menu  for  Program  MAPIT 


Input  Data _  Defaults  Description _ 

Invokes  the  HELP  utility 
that  lists  valid  user 
responses . 


X2  X2P  none  SINGLE  region  mapping. 

X2  -  distance  from 
origin  to  far 
end  of  region. 

X2P  -  cell  width  at 
last  cell  in 

region. 

X3  X3P  L3  L2  none  DOUBLE  region  mapping. 

X3  -  distance  to  far 
end  of  region 
partition. 

X3P  -  cell  width  of 
last  cell  in 
region. 

L3  -  cell  number  of 
last  cell  in 
region. 

L2  -  cell  number  of 
cell  at  center 
of  region. 

IREG  none  Recompute  region  mapping 

IREG  -  region  number 

to  be  remapped. 


none  Produces  a  summary  of 

all  mapping  previously 
performed. 


none 


Ends  mapping  direction. 


"ON"  "OFF"  "OFF"  Prints  diagnostics  and 

intermediate 
computations . 
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39.  A  SINGLE  command  specifies  a  region  composed  of  one  stretching 
function.  Variable  X2  defines  the  distance  from  the  axis  origin  to  the  far 
edge,  or  partition,  of  the  region.  Variable  X2P  defines  the  grid  cell  width 
at  the  far  edge. 

40.  A  DOUBLE  command  specifies  a  region  composed  of  two  stretching 
functions.  Variable  X3  defines  the  distance  from  the  axis  origin  to  the  far 
edge,  or  partition  of  the  region,  and  variable  X3P  is  the  width  of  the  last 
cell  in  that  region.  The  user  must  also  specify  the  cell  number  at  the  far 
edge  of  the  region  (variable  L3)  and  the  cell  number  at  the  center  of  the 
region  (variable  L2). 

41.  The  solution  algorithm  in  program  MAPIT  will  diverge  if  improper 
values  are  entered  for  a  region.  If  the  solution  does  diverge,  convergence 
can  normally  be  achieved  by  adjusting  the  values  for  variables  X3P  and/or  L2 . 
Additional  information  concerning  the  divergence/convergence  of  the 
computational  algorithm  is  discussed  in  the  section  titled  "Computational 
Technique  of  Program  MAPIT." 

42.  An  option  is  included  in  program  MAPIT  to  allow  the  user  to 
recompute  regions  (option  BACKUP).  However,  all  regions  mapped  subsequent  to 
the  initial  attempt  of  a  remapped  region  will  be  deleted. 

43.  Mapping  is  terminated  by  entering  the  ENDDIR  command.  The  user  is 
then  prompted  to  map  the  remaining  direction  or  terminate  the  mapping  session. 
Program  execution 

44.  The  program  will  prompt  the  user  for: 

a.  A  mapping  direction  (either  x-  or  y-axis). 

b.  The  initial  distance  to  the  grid  origin  (x)  which  is  usually 
set  to  0.0, 

£.  The  initial  grid  cell  index  number  (ALPHA),  which  is  usually  set 
to  1 . 

d.  Initial  cell  width. 

45.  The  interactive  session  begins  by  entering  the  command: 
h2crplcl :  Iarry$/u3/h2crj>lc0/em* 

on  the  CRAY  Y-YMP  supercomputer  located  at  WES  (see  Chapter  2).  It  should  be 
noted  that  user  entries  are  shown  as  shaded  and  the  CMS  response  "screens"  are 
shaded  boxes . 
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The  CMS  responds: 


cccc 

M 

M 

SSSS 

GGGG 

RRRRR 

I 

DDDDD 

c  c 

MM 

MM 

S  S 

G  G 

R  R 

I 

D  D 

c 

M  M 

M  M 

S 

G 

R  R 

I 

D  D 

c 

M  M 

M 

SSSS 

G 

RRRRR 

I 

D  D 

c 

M 

M 

s 

G  GGG 

R  R 

I 

D  D 

c  c 

M 

M 

s  s 

G  G 

R  R 

I 

D  D 

cccc 

M 

M 

SSSS 

GGGG 

R  R 

I 

DDDDD 

Return 

for  more . . . 

********************************************************************* 
*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 
********************************************************************* 


Options : 

On-Line  Help  . - . > 

Enter  CMSGRID  Module  . > 


Return  to  Main  Menu 


********************************************************************* 


Enter  option  number 


*  CMSGRID  COMPONENTS  * 

*  MAPIT:  (Stretched/constant  rectangular  * 

*  coordinate  grid  generator)  . -->  1  * 

*  * 

*  DRAWIT:  (Graphical  program  to  plot  grids  * 

*  generated  by  MAPIT)  . >  2  * 

*  * 

*  LISTIT:  (Program  to  print  grid  coordinate  * 

*  points)  - >  3  * 

*  * 

*  EXIT:  (Terminate  computer  session)  . . >  4  * 


*************************r*ilnfr********************'************* 


The  user  is  prompted  to  select  a  CMSGRID  component: 
Enter  option  number  - >  |j 

The  CMS  responds: 


X 

X 

X 

XXXXXX 

XXXXXXX 

xxxxxxx 

XX 

XX 

X  X 

X  X 

X 

X 

X  X 

X  X 

X  X 

X  X 

X 

X 

X 

XXX 

xxxxxxx 

XXXXXX 

X 

X 

X 

X  X 

X  X 

X 

X 

X 

X 

X 

X  X 

X 

X 

X 

X 

X 

X  X 

Return 

X 

for  more . . 

xxxxxxx 

X 

The  user  is  prompted  to  provide  a  name  for  the  output  file  which  will  contain 
the  grid  stretching  coefficients: 

Enter  output  file  name  2*£6«2.a*p 

The  user  is  prompted  to  select  a  mapping  direction: 


SPECIFY  MAPPING  DIRECTION  (X  OR  Y) : 

NOTE:  REGIONS  MUST  BE  MAPPED  IN  SEQUENCE... 

X 


A- 19 


The  user  is  prompted  for  an  initial  distance  for  the  grid  origin  (x)  and  an 
initial  grid  cell  index  number  (ALPHA) : 


SPECIFY  INITIAL  X  DISTANCE  AND  ALPHA 

(CARRIAGE  RETURN  EMPLOYS  DEFAULTS:  X-0.0  AND  ALPHA-1) 

***  USE  ONLY  INTEGERS  FOR  ALL  ALPHAS  INPUT!!! 

0.0  1 


The  user  is  prompted  for  an  initial  cell  size  (x'): 


SPECIFY  ASSOCIATED  DERIVATIVE  X- PRIME: 

l. 


The  user  may  now  chose  to  display  a  menu  of  valid  commands: 

CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

...ENTER  "MENU"  OR  "?"  TO  SEE  MENU... 

. . .PLEASE  USE  UPPERCASE. . . 

I 

The  program  responds : 


INSTRUCTION  MENU  FOR  PROGRAM  MAPIT: 


KEYWORD: 

INPUT  DATA: 

DEFAULTS: 

KEYWORD  FUNCTION: 

MENU 

PRINTS  THIS  MENU 

SINGLE 

X2  X2P 

NONE 

SINGLE  REGION  MAPPING 

DOUBLE 

X3  X3P  AL3  AL2 

NONE 

DOUBLE  REGION  MAPPING 

BACKUP 

REG 

CURRENT  REG 

BACK  UP/REDO  REGION  (REG-0 
RESTARTS  DIR) 

SUMMARY 

SUMMARIZES  MAPPING  WORK  DONE  SO 
FAR 

ENDDIR 

ENDS  THIS  MAPPING  DIRECTION  AND 
SAVES  DATA 

DEBUG 

"ON"  OR  "OFF" 

"OFF" 

PRINTING  SWITCH  FOR  PROGRAM 
DEBUGGING 

AN,  MPUMTIQN  PF...T.HE-IJTO.  .DATA; 

X2  -  DISTANCE  AT  RIGHT  SIDE  OF  A  SINGLE  REGION 

X2P  -  SLOPE  (X-PRIME)  AT  RIGHT  SIDE  OF  A  SINGLE  REGION 

X3  -  DISTANCE  AT  FAR  END  OF  THE  SECOND  REGION 

X3P  -  SLOPE  (X-PRIME)  AT  FAR  END  OF  THE  SECOND  REGION 

AL3  -  ALPHA  AT  FAR  END  OF  THE  SECOND  REGION 

AL2  -  ALPHA  AT  THE  MIDDLE  REGION  LINE  OF  A  DOUBLE  REGION 

REG  -  THE  REGION  NUMBER  YOU  WISH  TO  REMAP 

(NOTE  ALL  MAPPING  COMPUTATIONS  AFTER  THIS  REGION  ARE 
WRITTEN  OVER  AND  WIPED  OUT) 
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The  user  selects  a  single  region  15  units  long  with  an  ending  cell  size  of  1 
unit: 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
...ENTER  "MENU"  OR  "?"  TO  SEE  MENU... 
. . .PLEASE  USE  UPPERCASE. . . 

SINGLE  15.  1. 


Since  the  Initial  cell  size  (x')  was  1  unit,  then  the  cells  for  this  region 
are  a  constant  value  of  1  unit.  The  program  responds: 


XI  - 

FOR  REGION 
0.00000 

1 

ALPHAl  - 

1 

XI  PRIME 

-  1.00000000 

X2  - 

15.00000 

ALPHA2  - 

16 

GIVEN  X2 

PRIME  -  1 . 00000000 

X2CALC  - 

15.00000 

CALC  X2 

PRIME  -  1 . 00000000 

A  -  - . 100000000000000000E+01 
B  -  0.100000000000000000E+01 
C  -  0 . 100000000000000000E+01 


The  user  selects  a  single  region  ending  25  units  from  the  origin  with  an 
ending  cell  size  of  0.5  units: 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
...ENTER  "MENU"  OR  "7"  TO  SEE  MENU... 
. . .PLEASE  USE  UPPERCASE. . . 

SINGLE  25.  .5 


The  program  responds: 


XI  - 

FOR  REGION 
15.00000 

1 

ALPHAl  - 

16 

XI 

PRIME  - 

1.000000000 

X2  - 

25.00000 

ALPHA2  - 

30 

GIVEN 

X2 

PRIME  - 

1.000000000 

X2CALC  - 

24.74005 

CALC 

X2 

PRIME  - 

0.52722165 

A  -  0 . 88764562 1036801458E+03 
B  -  - .918153961332387552E+03 
C  -  - . 183350487463515010E-01 


The  user  has  completed  mapping  the  x-direction: 
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CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

.ENTER  "MENU"  OR  "?"  TO  SEE  MENU. . . 
. . .PLEASE  USE  UPPERCASE. . . 


The  program  responds: 


X- DIRECTION  MAPPING  COMPLETE:  2  REGIONS 


REG 

X- SPACE 

ALPHA 

X- PRIME  A 

B  C 

FROM  TO 

FROM 

TO 

FROM  TO 

1 

0.0000  15.0000 

1 

16 

1.000  1.000  -1.000 

1 . 000  1 . 000 

2 

15.0000  25.0000 

16 

30 

1.000  0.527  887.6 

-918.2  - .1834E-01 

The  user  selects  to  map  another  direction: 


MAPPING  IN  THE  X  DIRECTION  IS  COMPLETED 
DO  YOU  WISH  TO  MAP  IN  ANOTHER  DIRECTION  (Y/N)? 

I 


The  user  specifies  which  direction  to  map: 


SPECIFY  MAPPING  DIRECTION  (X  OR  Y) : 

1 


The  user  is  prompted  for  an  initial  distance  from  the  grid  origin  (Y)  and  an 
initial  cell  size  (ALPHA) : 


SPECIFY  INITIAL  Y  DISTANCE  AND  ALPHA 

(CARRIAGE  RETURN  EMPLOYS  DEFAULTS:  Y-0.0  AND  ALPHA-1) 

***  USE  ONLY  INTEGERS  FOR  ALL  ALPHAS  INPUT!!! 


0.0  t 


The  user  is  prompted  for  an  initial  cell  size  (Y  ). 
SPECIFY  ASSOCIATED  DERIVATIVE  Y- PRIME: 

II 


The  user  selects  a  single  region  15  inches  in  length  with  a  cell  size  of  1 


CHOOSE  AN  INSTRUCTION  FORM  THE  MENU: 

. .  .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

. . .ENTER  "MENU"  OR  "?"  TO  SEE  MENU. . . 
. . .PLEASE  USE  UPPERCASE. . . 


Since  the  initial  cell  size  (Y')  was  1  inch,  then  the  cells  for  this  region 
are  a  constant  value  of  1  inch.  The  program  responds: 


Y1  - 

FOR  REGION 
0.00000 

1 

ALPHAl  - 

1 

Y1 

PRIME  - 

1.00000000 

Y2  - 

15.00000 

ALPHA2  - 

16 

GIVEN  Y2 

PRIME  - 

1.00000000 

Y2CALC  - 

15.00000 

CALC  Y2 

PRIME  - 

1.00000000 

A  -  - . 100000000000000000E+01 
B  -  0.100000000000000000E+01 
C  -  0 . 100000000000000000E+01 


The  user  has  completed  mapping  the  y-direction: 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

. . .ENTER  "MENU"  OR  "?"  TO  SEE  MENU. . . 
. . .PLEASE  USE  UPPERCASE. . . 


Hi 


The  program  responds : 


Y-DIRECTION  MAPPING  COMPLETE:  1  REGIONS 


REG 

1 


Y- SPACE  ALPHA 

FROM  TO  FROM  TO 

0.0000  15.0000  1  16 


Y- PRIME  A 

FROM  TO 

1.000  1.000  -1.000 


B 

1.000 


C 

1.000 


MAPPING  IN  THE  Y  DIRECTION  IS  COMPLETED 
DO  YOU  WISH  TO  MAP  IN  ANOTHER  DIRECTION  (Y/N)? 

N 

The  system  responds: 

STOP 

CP:  0.010s,  Wallclock:  70.114s 


***  END  OF  CMSGRID  PROCEDURE  *** 
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£cg&E3tt  jamamfc 

46.  Output  of  program  MAPIT  consists  of  a  file  containing  the  XSTRETCH 
and  YSTRETCH  records  used  by  aodels  W1FM  and  SPH.  These  records  can  be 
directly  added  to  those  models'  input  data  files.  Furthermore,  this  file  can 
be  processed  using  programs  LISTIT  and  DRAWIT,  which  are  discussed  in  the 
following  sections . 
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Program  DRAWIT 


47.  Program  DRAWIT  is  an  interactive  program  for  graphically  displaying 
and/or  plotting  the  computational  grid  produced  by  program  MAPIT.  Hence, 
program  MAPIT  must  be  executed  first  to  develop  the  grid  stretching 
coefficients.  In  addition,  bathymetric  data  can  be  plotted  directly  on  the 
computational  grid,  if  such  data  are  available  in  a  computer  file  in  the 
format  shown  below: 

BATHSPEC  FEET  0.0  0.0  -10.0  XY  (9F8.2) 


-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

48.  Program  DRAWIT  presently  can  generate  graphical  output  for  the 
following  devices : 

ij.  Tektronix  4014  terminals,  DEC  VT  series  terminals,  or  compatible 
devices . 

b.  Hewlett  Packard  DraftMaster  II  drum  plotters  or  compatible  devices. 

49.  A  drum  plotter  is  typically  used  for  producing  map  overlays.  These 
overlays  are  very  helpful  when  developing  input  bathymetry/topography  data  set 
for  models  such  as  WIFM.  Presently,  the  map  overlays  can  be  plotted  at  the 
Waterways  Experiment  Station  (WES)  Coastal  Engineering  Research  Center  (CERC) 
or  Information  Technology  Laboratory  (ITL).  The  user  may  wish  to  contact 
their  ADP  coordinator  to  determine  whether  a  plot  file  can  be  plotted  on  in- 
house  devices . 

Program  execution 

50.  The  interactive  session  begins  by  entering  the  command: 
h2crplcl :  larry$|j^i^ppiBpiii^ 

The  CMS  responds : 
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V  E  L  C 

0  M  E 

TO.. 

• 

XXXXX 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more. . . 

********************************************************************* 

*  CMS  COMPONENTS  * 

*  . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . - . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 

********************************************************************* 


Enter  option  number 


The  CMS  responds : 


CCCC  M  M 

C  C  MM  MM 

C  HHHN 

C  M  M  M 

C  MM 

C  C  M  M 

CCCC  M  M 


SSSS  GGGG 

S  S  G  G 

S  G 

SSSS  G 

S  G  GGG 

S  S  G  G 

SSSS  GGGG 


RRRRR 

I 

DDDDD 

R 

R 

I 

D 

D 

R 

R 

I 

D 

D 

RRRRR 

I 

D 

D 

R 

R 

I 

D 

D 

R 

R 

I 

D 

D 

R 

R 

I 

DDDDD 

Return  for  more . . . 


Enter  option  number 


>  1 
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a******************'****  A  *  MrfcHHHHI  >  **,*  *-A  **iNr*^"*  *  Itie  k  kk  k  iHHHHHHHt 


*  CMSGRID  COMPONENTS  * 

♦*******♦**♦**♦♦•*'*:♦****♦**♦*****  ***♦♦*********♦♦'******'*•*'***** 

*  MAP IT:  (Stretched/constant  rectangular  * 

*  coordinate  grid  generator)  . >  1  * 

*  * 

*  DRAWIT:  (Graphical  program  to  plot  grids 

* 

*  generated  by  MAPIT)  - - - . — >  2  * 

*  * 

*  LISTIT:  (Program  to  print  grid  coordinate 

* 

*  points)  - - - . — >  3  * 

*  * 


The  user  is  prompted  to  select  a  CMSGRID  component: 


Enter  option  number  . >  2 

The  CMS  responds : 


DDDDDD 

RRRRR 

A 

W 

w 

mini 

TTTTTTT 

D 

D 

R 

R 

A 

A 

W 

w 

i 

T 

D 

D 

R 

R 

A 

A 

W 

w 

i 

T 

D 

D 

RRRRR 

AAAAAAA 

u  w 

w 

i 

T 

D 

D 

R  R 

A 

A 

WWW  w 

i 

T 

D 

D 

R 

R 

A 

A 

ww 

ww 

i 

T 

DDDDDD 

R 

R 

A 

A 

w 

w 

mini 

T 

Return  for  more... 


The  user  is  prompted  for  the  file  name  generated  by  MAPIT  containing  grid 
stretching  coefficients: 

Enter  name  of  the  input  data  set  2*re*2.aap 

The  user  is  prompted  for  bathymetric  data  if  they  exist: 
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f 


Do  you  want  to  plot  bathymetric  data  on  the  grid 

I 


The  program  responds: 


CURRENT  PLOT 

FEATURE  SUMMARY: 

INDEX  DIRECTION: 

•X---- . Y . 

NO.  OF  GRID  CELLS: 

i 

TO  29  1  TO  15 

CURRENT  WINDOW: 

i 

TO  29  1  TO  15 

CURRENT  LENGTH: 

26.69(IN)  16.01(IN) 

CURRENT  SCALE: 

1.00 

PLOT  CELL  INDICES:  YES 

PLOT  BATHYMETRY: 

NO  BATHYMETRY  FILE:  N/A 

FTITLE: 

PRESS  RETURN  TO  CONTINUE 

.  .  . 

AVAILABLE  MENU  ITEMS 

: 

CHOICE: 

FUNCTION 

MENU 

PRINTS  THIS  LIST  OF  INSTRUCTIONS 

STOP 

ENDS  PROCEDURE 

FTITLE  PLTITL 

DECLARES  PLOT  TITLE... 64  CHAR  OR  LESS 

WINDOW  1X1,  1X2,  IY1 

,  IY2 

SELECTS  PLOT  WINDOW 

WHOLE 

SELECTS  WHOLE  GRID  FOR  PLOTTING 

SCALE  PLSCAL 

SELECTS  DESIRED  PLOTTING  SCALE 

INDICES 

CELL  INDICES  TO  BE  LABELLED 

NOINDICES 

NO  LABELLING  OF  CELL  INDICES 

BATH  BATHFIL 

BATHYMETRY  VALUES  TO  BE  INDICATED 

. . .  BATHYMETRY  DATA  TO  BE  READ  FROM  FILE: 

NOBATH 

BATHYMETRY  VALUES  WILL  NOT  BE  INDICATED 

SUMMARY 

PRINT  CURRENT  PLOT  FEATURES 

HARDCOPY 

GENERATE  THE  PLOT  (ON  THE  LOCAL 

PLOTFILE) 

CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 
.  . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

.  . .PLEASE  USE  UPPERCASE. . . 


A  selection  is  made  from  the  available  menu  items  given  in  Table  A- 3. 
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Table  A- 3 


Instruction 

MENU 

STOP 

TITLE 

WINDOW 

WHOLE 

SCALE 

INDICES 

NOINDICES 

BATH 

NOBATH 

SUMMARY 

HARDCOPY 


PRAWIX  iMtructlQM 


Data 


title 


1X1 , 1X2 , IY1 , 1X2 
(integers) 


Description _ 

Displays  instruction  commands. 

Terminates  program  execution. 

Writes  a  title  of  up  to  64  characters 
on  plot. 

Defines  a  subgrid  area  to  be  plotted. 
1X1  -  minimum  x-axis  cell  index 
1X2  -  maximum  x-axis  cell  index 
IY1  -  minimum  y-axis  cell  index 
IY2  -  maximum  y-axis  cell  index 

Entire  grid  will  be  plotted. 

Plotting  scale  to  enlarge  or  shrink 
grid  size  on  output  medium. 


Cell  indices  will  be  printed  on  plot. 

Cell  indices  will  not  be  printed  on 
plot . 

file  name  Bathymetry  values,  supplied  from  file 

listed  in  instruction,  will  be  printed 
on  plot. 

Bathymetry  values  will  not  be  printed. 
Displays  current  plotting  parameters. 
Produces  plot. 
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The  user  selects  not  to  plot  cell  Indices: 


PLOT  CELL  INDICES:  NO 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

. . .PLEASE  USE  UPPERCASE. . . 

The  user  selects  the  plot  generation  option: 

wm 

END  OF  DISSPLA  10.0  --  1375  VECTORS  IN  1  PLOTS. 

RUN  ON  10/25/90  USING  SERIAL  NUMBER  60  AT  USA  VICKSBURG  CORPS  OF 
ENGINEERS 

PROPRIETARY  SOFTWARE  PRODUCT  OF  ISSCO,  SAN  DIEGO,  CALIF. 

139  VIRTUAL  STORAGE  REFERENCES;  4  READS;  0  WRITES. 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
. . .PLEASE  USE  UPPERCASE. . . 


The  user  selects  to  end  the  DRAWIT  procedure : 

its 

***  PROGRAM  ENDING:  0  PLOTS  GENERATED 

STOP 

CP:  0.080S,  Wallclock:  111.689s 
***  END  OF  CMS POST  PROCEDURE 

51.  To  display  the  grid  on  a  terminal  screen,  the  user  sets  the 
terminal  to  TEK  4014  using  the  set  up  key  and  enters  the  command: 

h2c rp lc 1 : lar ry$  /u3/h2 crplcO/casplot 

The  system  responds: 


ENTER  POST- PROCESSOR  DIRECTIVES 

PLOT  FILE  GENERATED  BY  PID18433 
AT  ISSCO 

ON  OCT  25,  1990  14:27 


A-  31 


Figure  A-4.  Sample  grid  from  program  DRAWIT 

The  plotting  file  can  be  displayed  on  the  VAX  8800  by  following  the  procedure 
outlined  below.  The  metafile  created  by  the  CRAY  Y-MP  DRAWIT  program  (metfil) 
is  converted  to  a  hexafile  (metafile .hex)  using  the  CRAY  Y-MP  system  utility 
meta2hex  as  follows: 

h2crplcl : larry$  met«2hftX 

**************** 

*  CA-DISSPLA  * 

*  META2HEX  * 

**************** 

Enter  name  of  DISSPLA  metafile  to  be  converted  [popfil]: 

metfil 

Enter  name  of  output  hex  metafile  [metafile  .hex]  :  f|tl|tt 

*  Conversion  complete  -  output  file  is  metafile. hex  * 

STOP 

The  user  then  transfers  the  hexafile  to  the  VAX  8800  as  follows: 

h2crplcl : larry$  ftp 
Connected  to  wesim3. 

220  wesim3.army.mil  Wollongong  FTP  Server  (Version  5.1)  at  Wed 
Oct  10  10 : 56T 

Name  (wesim3 :h2crplcl) :  h2crplc0 
331  Password  required  for  h2crplc0. 

Password:  _ 

230  User  logged  in,  default  directory  $DISK2 : [H2CRPLC0] 

Remote  system  type  is  VMS 
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ftp>  pat  metafile 
200  PORT  Command  OK. 

125  File  transfer  started  correctly 

226  File  transfer  completed  ok 

119481  bytes  sent  1.2  seconds  (97Kbytes/s) 

ftp>  quit 

221  Goodbye. 

h2crplcl : larry$ 

Connection  closed  to  larry.wes.army.mil 
The  hexafile  is  then  converted  to  a  metafile  on  the  VAX  8800  using  the  system 
utility  HEX2META  as  follows: 

$  HEX2HETA 

**************** 

*  CA-DISSPLA  * 

*  HEX2META  * 

**************** 

Enter  name  for  output  binary  DISSPLA  metafile  [popfil.dat]:  <!refc> 
Enter  name  of  input  DISSPLA  hex  metafile  [metafile .hex] :  <r*t> 

*  Starting  translation  of  DISSPLA  hex  metafile  created  on  10/10/90  at 
10:56:40 

*  CRAY  filename  was  metfil 

*  Metafile  conversion  is  complete  output  file  is  POPFIL.DAT  * 


The  output  file  can  then  be  transferred  to  the  CERC  VAX  3300  for  plotting  on 
the  drum  plotter  by  invoking  the  command: 

COPY  WBSIK3HU8emaae  password* : :  $DISK3 :  [VAX8800  acct3popfil.dat  pictrar. 4|| 

52.  To  plot  on  the  drum  plotter  located  in  the  CERC  terminal  room,  the 
user  logs  onto  the  terminal  adjacent  to  the  drum  plotter  by  typing: 

C>  C  Surf  (Inlet,  or  Aeolus) 

The  system  will  prompt  the  user  for  a  VAX  3300  user  name  and  password.  Once 
logged  onto  the  VAX  3300,  the  user  must  create  a  file  called  DRUMPLT.FOR  as 
given  below: 

CALL  HP75 

CALL  METNAM( ' PICTUR' ,6) 

CALL  DISP0P(1) 

STOP 

END 

To  compile  and  link  the  DRUMPLT  file,  the  user  types: 

$  DISS  DRUMPLT 

To  produce  an  actual  size  plot,  type: 

$  Run  Druopit 


SzQ&im  14SHT 

53.  Program  LISTIT  produces  a  file  containing  a  listing  of  the 
stretched  rectilinear  coordinates  computed  from  the  stretching  coefficients 
generated  by  program  MAPIT.  Therefore,  program  MAPIT  must  be  executed  first, 
and  its  output  file  stored  as  an  indirect  access  file  before  attempting  to  use 
program  LISTIT. 

Program  execution 

54.  Program  LISTIT  is  executed  interactively  by  the  commands: 
h2crplcl : Iarry$/tt3/h2c*plft0/c»» 

The  CMS  responds : 


WELCOME 

T  0  . 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  X  X  X  X 

X 

x  XX 

X 

xxxxx 

X  X 

X 

X 

XX  x 

X 

X  X 

xxxxx  x 

X 

xxxxx 

Return  for 

more . . . 
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*  CMS  COMPONENTS  * 

*  . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . - . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 

********************************************************************* 


Enter  option  number  - - - . >  1 

The  CMS  responds : 


CCCC  M  M  SSSS  GGGG  RRRRR  1  DDDDD 

CC  MM  MM  S  S  GGRRIDD 
C  MMMMS  G  RRID 

C  M  M  M  SSSS  G  RRRRR  I  D 

C  MM  S  G  GGG  R  R  ID 

CC  M  MSS  GGRR  IDD 
CCCC  M  M  SSSS  GGGG  R  R  I  DDDDD 


Return  for  more . . . 


o  o  o 


* 

* 

* 


USING  THE  COASTAL  MODELING  SYSTEM 


* 

* 

* 

* 

* 

* 

* 

* 

* 


* 

* 

* 


■  « »  ill  ill  ill  .1  I  lull  li  iL  I  ill  ill  ill  ill  -iLit-ifc  .lr  ilnlt  ill  1.  I  ti  I.  11.  ill- ill  ilril.  -  L  .1.  ifc  1— •  -«-  |  1-.«. * — i  —  ,|r-|,  lr-| 


Options : 

On-Line  Help  . - . - . . . - . >  1 

Enter  CMSGRID  Module  . . . . >  2 

Return  to  Main  Menu  - - - - - . . >  3 


* 

* 

* 

* 

* 

* 

* 

* 

* 


Enter  option  number  . - . >  2 


************************************************************* 


*  CMSGRID  COMPONENTS  * 

************************************************************* 

*  MAPIT:  (Stretched/constant  rectangular  * 

*  coordinate  grid  generator)  . >  1  * 

*  * 

*  DRAWIT:  (Graphical  program  to  plot  grids  * 

*  generated  by  MAPIT)  . >  2  * 

*  * 

*  LISTIT:  (Program  to  print  grid  coordinate  * 

*  points)  . - . >  3  * 

*  * 

*  EXIT:  (Terminate  computer  session)  . >  4  * 


j  ************************************************************* 
The  user  is  prompted  to  select  a  CMSGRID  component: 

Enter  option  number  . . >  $ 


The  CMS  responds : 


X 

X 

xxxxx 

xxxxxxx 

X 

xxxxxxx 

X 

X 

X  X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

xxxxx 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X  X 

X 

X 

X 

xxxxxxxx 

X 

xxxxx 

X 

X 

X 

Return  for 

more . . . 

Enter  name  of  the  input  data  set  tt0£k.flMg> 

Enter  name  of  the  output  file  gioetc.lftfc 
The  system  responds : 

. . .NORMAL  TERMINATION. . .PROCESSING  FINISHED 
STOP 

CP:  0.019S,  Wallclock:  0.028s,  10.9%  of  6-CPU  Machine 

***  END  OF  CMS POST  PROCEDURE 

Program  LISTIT  produces  an  output  file  containing  the  grid  coordinates. 
"FACE"  indicates  the  location  of  the  edge  of  a  grid  cell  and  "CENTER" 
indicates  the  location  of  the  grid  cell  center.  Output  file  mock. 1st  is 
displayed  as  follows: 
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h2crplcl:larry$ 

***  SUMMARY  OF  MAPPED  REGIONS: 


REGION  NO.  CELL  ALPHA  ABC 


XREGION 

1 

FROM 

1 

TO 

30 

FROM 

1. 

TO 

31. 

-1.00000 

1.00000 

1.00000 

YREGION 

1 

1 

15 

1. 

16. 

-1.00000 

1.00000 

1.00000 

***  SUMMARY  OF  X- COORDINATES : 
CELL 


INDEX 

ALPHA 

FEATURI 

i  X 

X' 

X" 

1.0 

FACE 

0.0000000000 

1 . 0000000000 

0.0000000000 

1 

1.5 

CENTER 

0 . 5000000000 

1 . 0000000000 

0.0000000000 

2.0 

FACE 

1.0000000000 

1 . 0000000000 

0.0000000000 

2 

2.5 

CENTER 

1 . 5000000000 

1.0000000000 

0.0000000000 

3.0 

FACE 

2.0000000000 

1.0000000000 

0.0000000000 

3 

3.5 

CENTER 

2 . 5000000000 

1.0000000000 

0.0000000000 

4.0 

FACE 

3.0000000000 

1 . 0000000000 

0 . 0000000000 

4 

4.5 

CENTER 

3.5000000000 

1.0000000000 

0.0000000000 

5.0 

FACE 

4.0000000000 

1 . 0000000000 

0.0000000000 

5 

5.5 

CENTER 

4.5000000000 

1 . 0000000000 

0.0000000000 

6.0 

FACE 

5.0000000000 

1 . 0000000000 

0.0000000000 

6 

6.5 

CENTER 

5 . 5000000000 

1.0000000000 

0.0000000000 

7.0 

FACE 

6.0000000000 

1 . 0000000000 

0 . 0000000000 

7 

7.5 

CENTER 

6 . 5000000000 

1 . 0000000000 

0.0000000000 

8.0 

FACE 

7 . 0000000000 

1.0000000000 

0.0000000000 

8 

8.5 

CENTER 

7 . 5000000000 

1 . 0000000000 

0 . 0000000000 

9.0 

FACE 

8.0000000000 

1 . 0000000000 

0.0000000000 

9 

9.5 

CENTER 

8 . 5000000000 

1 . 0000000000 

0.0000000000 

REFERENCE 
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Inti94usUop 

1.  CMSUTIL  is  the  software  package  in  the  Coastal  Model  System  (CMS) 
that  provides  the  user  access  to  programs  that  supplement  the  CMS  models. 
Presently,  the  following  programs  reside  in  this  package: 

TIDEGEN  Generates  tidal  elevation  time -history  data  at 

select  locations  from  tidal  harmonic 
constituents . 

TIDECON  Synthesizes  tidal  harmonic  constituents  from 

a  time  series  of  hourly  tidal  elevations. 

2.  Descriptions  of  each  program,  including  data  requirements  and 
execution  procedures,  are  provided  in  the  following  sections. 

Fxgfctaffl.JIPJEg.ES 

3.  Program  TIDEGEN  generates  a  time  series  of  tidal  elevations  from 
tidal  harmonic  constituents .  The  mathematical  procedures  used  to  produce  the 
data  are  described  in  Schureman*.  This  program  can  simultaneously  process 
records  for  a  maximum  of  60  gage  locations.  The  following  data  are  required 
for  each  gage: 

a.  Longitude  of  the  gage. 

b.  Constituents  that  are  applicable  to  that  gage  location. 

c.  Amplitudes  and  epochs  corresponding  to  each  constituent  selected 
in  item  b. 

d.  Starting  date  and  local  time  at  the  specified  longitude. 

4.  The  National  Ocean  Service  (NOS)  provides  amplitude  and  epoch  data 
for  different  tidal  constituents  at  US  coastal  locations.  To  facilitate  the 
use  of  NOS  information,  program  TIDEGEN  uses  the  same  constituent  names  as 
NOS.  Table  B-l  presents  a  list  of  those  constituents  available  for  use  in 
this  program. 

5.  The  output  of  TIDEGEN  consists  of  a  file  containing  the  computed 
water  surface  elevations  and  an  optional  printout  of  the  constituents.  Model 
WIFM  contains  TIDEGEN  as  a  component  to  compute  the  tide  data  internally 
during  the  course  of  a  simulation.  However,  it  is  suggested  that  the  user 

P.  Schureman,  1958,  "Manual  of  Harmonic  Analysis  and  Prediction  of  Tides," 
Special  Publication  No.  98,  US  Coast  and  Geodetic  Survey,  Department  of 
Commerce,  Washington,  DC. 
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reproduce  Che  data  with  TIDEGEN  before  running  VIFM  to  check  the  accuracy  of 
the  program  output.  Tide  elevations  may  be  plotted  using  program  HYDPLT  in 
package  CMSPOST  (Appendix  C) . 

6.  The  first  tidal  elevation  in  the  output  file  corresponds  to  the 
starting  date  and  time.  Time  intervals  between  subsequent  tidal  elevations 
are  constant;  however,  the  time  interval  depends  on  the  total  length  of  time 
for  which  output  data  are  generated.  Table  B-2  presents  the  time  intervals  at 
which  the  output  data  are  generated. 

Data  requirements 

7.  An  instruction  file  containing  certain  input  data  records  must  be 
created  before  executing  the  TIDEGEN  program  (see  Table  B-3).  Each 
instruction  or  data  record  in  the  file  must  begin  with  a  record  identifier 
starting  in  column  1,  which  identifies  the  type  of  data.  For  example,  record 
identifier  EPCH1  is  for  the  epoch  of  each  constituent  associated  with  gage  1, 
AMPL1  is  for  the  amplitude  of  each  constituent  associated  with  gage  1,  and  so 
forth.  Table  B-3  presents  the  instruction  file  records  applicable  to  this 
program.  Data  to  the  right  of  the  record  identifiers  are  read  format -free. 
These  data  must  be  separated  by  at  least  one  blank  column  (commas  cannot  be 
used).  Note  the  "Type"  designations  [R]  and  [0]  in  column  1  of  Table  B-3 
indicate  required  and  optional  records,  respectively. 

8.  The  TITLE  record  gives  the  simulation  a  general  title  that  can  be 
used  by  the  plotting  program,  HYDPLT.  The  TIMES  record  specifies  the  starting 
time  for  computing  tidal  elevation  data.  Parameters  contained  on  this  record 
include  the  year,  month,  day,  and  hour  for  beginning  the  simulation  and  the 
length  of  the  simulation,  in  hours.  The  GNAM_  record  is  used  to  give  a 
reference  name  to  a  particular  time  series,  or  gage.  (The  _  is  explained  in 
the  following  paragraph.) 

9.  Each  gage  requires  one  set  of  GNAM_,  L0NG_,  CNST_,  AMPL_,  and  EPCH_ 
commands,  entered  in  the  order  specified  in  Table  B-3.  The  record  identifiers 
describing  the  gage,  constituent,  amplitude,  epoch,  and  longitude  data  require 
a  qualifier  or  number  that  corresponds  to  the  gage  number.  This  qualifier 
must  be  immediately  adjacent  to  the  record  identifier.  The  first  gage  has  the 
qualifier  "1,"  the  second  gage  has  the  qualifier  "2,"  and  so  forth. 

10.  The  L0NG_  provides  the  longitude  (in  degrees)  west  of  the  Greenwich 
meridian  for  the  specific  gage.  If  the  command  L0NG1  Is  omitted,  the  time 
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Tab la  B-l 


List  of  Available  Constituents 


Reference 

NOS 

Number 

flame 

1 

M2 

Semidiurnal 

2 

S2 

Semidiurnal 

3 

N2 

Semidiurnal 

4 

K1 

Diurnal 

5 

M4 

Shallow-water  quarter  diurnal 

6 

01 

Diurnal 

7 

M6 

Shallow-water  sixth  diurnal 

8 

MK3 

Shallow-water  terdiurnal 

9 

S4 

Shallow- water  quarter  diurnal 

10 

MN4 

Shallow-water  quarter  diurnal 

11 

NU2 

Semidiurnal 

12 

S6 

Shallow-water  sixth  diurnal 

13 

MU2 

Semidiurnal 

14 

2N2 

Semidiurnal 

15 

001 

Diurnal 

16 

LAMBDA2 

Semidiurnal 

17 

SI 

Diurnal 

18 

Ml 

Diurnal 

19 

J1 

Diurnal 

20 

MM 

Long-period 

21 

SSA 

Long-period 

22 

SA 

Long -period 

23 

MSF 

Long-period 

24 

MS 

Long-period 

25 

RH01 

Diurnal 

26 

Q1 

Diurnal 

27 

T2 

Semidiurnal 

28 

R2 

Diurnal 

29 

2Q1 

Diurnal 

30 

PI 

Diurnal 

31 

2SM2 

Shallow-water  semidiurnal 

32 

M3 

Terdiurnal 

33 

L2 

Semidiurnal 

34 

2MK3 

Shallow-water  terdiurnal 

35 

K2 

Semidiurnal 

36 

M8 

Shallow-water  eight  diurnal 

37 

MS4 

Shallow-water  quarter  diurnal 

Table  B-2 


TIDEGEN  Output  Data  Time  Intervals 


Simulation  Length 

Time  Interval 

hr 

min 

< 

1.5 

0.5 

1.5 

- 

3.0 

1.0 

3.0 

- 

7.0 

2.0 

7.0 

- 

15.0 

5.0 

15.0 

- 

25.0 

10.0 

25.0 

- 

45.0 

15.0 

45.0 

- 

90.0 

30.0 

90.0 

60.0 

specified  in  command  TIMES  would  default  to  Greenwich  time.  For  each  selected 
constituent  for  a  particular  gage,  the  user  must  specify  a  corresponding 
amplitude  using  record  AMPL_.  For  example,  if  GNAM1  has  constituents  M2  and 
S2,  then  record  AMPL1  would  contain  two  amplitudes,  one  corresponding  to 
constituent  M2  and  the  other  corresponding  to  S2.  Similarly,  the  epoch  is 
provided  for  each  constituent  selected  for  a  particular  gage  using  record 
EPCH_. 

11.  Constituents  are  designated  on  the  CNST_  record  by  their  reference 
number,  or  index  (see  Table  B-l)  rather  than  by  their  names.  However,  if  all 
37  constituents  are  desired,  the  user  may  enter  "ALL"  instead  o.!.  listing  all 
of  the  reference  numbers.  Also,  if  some  of  the  reference  numbers  are 
consecutive,  the  user  can  list  the  first  number,  Immediately  followed  by  a 
hyphen,  then  the  last  reference  number  (e.g.,  5-9  would  include  constituents  5 
through  9  from  Table  B-l). 
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12.  The  following  example  illustrates  the  structure  of  the  instruction 

file: 


TITLE 

EXAMPLE  INSTRUCTION  FILE 

TIMES 

1987  2  14  12  36 

GAGE1 

GAGE  NO.  1 

L0NG1 

135.0 

CNST1 

1  3 

AMPL1 

2.0  0.5 

EPCH1 

35.0  90.0 

GAGE2 

GAGE  NO.  2 

L0NG2 

135.2 

CNST2 

3-5 

AMPL2 

0.25  0.10  0.05 

EPCH2 

15.0  5.0  45.0 

13.  For  this  example,  two  tidal  elevation  time -histories  will  be 
generated.  The  starting  date  and  time  for  each  gage  is  12  noon  on  14  February 
1987  (local  time),  and  data  will  be  produced,  at  10-min  intervals,  for  the  36- 
hr  record  length. 

14.  Gage  no.  1  is  located  135.0  deg  west  of  the  Greenwich  meridian 
(i.e.,  command  L0NG1) .  Constituents  M2  and  N2,  selected  with  command  CNST1 
(see  Table  B-l)  are  used  to  generate  the  tidal  elevation  time-history. 
Constituent  M2  has  an  amplitude  of  2.0  ft  and  an  epoch  of  35.0  deg. 

Constituent  N2  has  an  amplitude  and  epoch  of  0.5  ft  and  90.0  deg, 
respectively. 

15.  Three  constituents  are  used  to  generate  the  tidal  elevation  time- 
history  for  the  second  gage.  These  constituents  are  N2,  Kl,  and  M4. 

Amplitudes  and  epochs  are  assigned  to  their  respective  constituents  in  the 
same  fashion  as  for  gage  no.  1. 

Program  execution 

16.  After  creating  and  saving  the  instruction  file,  the  user  enters  the 
following  interactive  command  at  the  system  prompt: 


h2crplcl :  larry$|^ii||il|||ii| 
system  prompt  user  entry 


It  should  be  noted  that  user  entries  are  shown  as  shaded,  and  CMS  response 
"screens"  are  shaded  boxes. 

The  CMS  responds : 


WELCOME 

to'.  . 

*  . 

XXXXX  X 

X 

XXXXX 

X  X  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

Return  for 

X 

more . . . 

XXXXX 

********************************************************************* 


CMS 


COMPONENTS 


*  Options: 

* 

*  CMSGRID  (Maps,  plots,  and  lists  the  nunerical  grid) 

* 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes 


*  CMSPOST  (Plots  and  lists  model  outputs) 

* 

*  CMSUTIL  (Additional  "utility"  programs) 

* 

*  Exit  CMS  . 


* 

* 

->  1  * 


*  numerical  models)  . . . . . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . . . * . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 

********************************************************************* 


To  enter  CMSUTIL,  the  user  enters  a  value  of  4: 

Enter  option  number  . . >  4 

The  CMS  responds : 
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cccc 

M  M 

SSSS 

u 

u 

TTTTTTT 

I 

L 

c  c 

MM  MM 

s  s 

u 

u 

T 

I 

L 

c 

M  M  M  M 

s 

u 

u 

T 

I 

L 

c 

M  M  M 

SSSS 

u 

u 

T 

I 

L 

c 

M  M 

s 

u 

u 

T 

I 

L 

c  c 

M  M 

S  S 

u 

u 

T 

I 

L 

cccc 

M  M 

SSSS 

uuuu 

T 

I 

LLLLLL 

Return  for  more _ 


****************************************<  *  At  ************************** 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

*  * 

*  Options:  * 

*  .  * 

*  On-Line  Help  . . . . . >  1  * 

*  * 

*  Enter  CMSUTIL  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . - - -  - - - - >  3  * 

*  -  * 


*  Return  to  Main  Menu  . . - - -  - - - - >  3  * 

*  * 


Enter  option  number 


>  2 


******************************************************************* 
*  CMSUTIL  MENU  * 

******************************************************************* 


* 

* 

* 

* 

* 

* 

* 

* 

* 


TIDEGEN  Generates  a  time  series  of  tidal  elevations 

from  harmonic  and  tidal  constituents.  - >  1 

TIDECON  Synthesizes  harmonic  constituents  from  time 

series  of  hourly  tidal  elevation  data.  - >  2 

EXIT  . >  3 


* 

* 

* 

* 

* 

* 

* 

* 

* 


******************************************************************* 


To  execute  program  TIDEGEN,  the  user  enters  a  value  of  1: 

Enter  option  number  . . >  | 

The  CMS  responds: 
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Enter  the  name  of  the  Instruction  file: 

The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  file. 

Enter  the  name  of  the  output  file  containing  water  surface  elevations: 
tidegen.hyd 

Constituent  print-out  desired?  § 

Enter  the  name  of  the  constituent  output  file: 

The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 

Request  1234 . iarry  submitted  to  queue  prime. 

The  user  enters  a  3  to  terminate  the  CMSUTIL  session  and  return  to  the  main 
menu . 

Program  output 

17.  Program  TIDEGEN' s  output  file  containing  the  time  series  of  tidal 
elevations  for  each  gage  can  be  printed  for  inspection  of  the  values,  or  it 
can  be  used  as  direct  input  to  models  WIFM  and  CLHYD  or  the  plotting  program 
HYDPLT  in  package  CMSPOST. 


B-10 


******************************************************************* 

*  CMSUTIL  MENU  * 

******************************************************************* 

* 

Generates  a  time  series  of  tidal  elevations  * 

from  harmonic  and  tidal  constituents.  . >  1  * 

* 

Synthesizes  harmonic  constituents  from  time  * 

series  of  hourly  tidal  elevation  data.  - >2  * 

* 

. >  3  * 

it 

*******ick****i'i'ic***irkieirk***icici'irk******irk*****icirk****ic**'k****ie*ic**** 


* 

* 

* 

* 

TIDEGEN 

* 

* 

* 

TIDECON 

* 

* 

EXIT  - 

Program  TIDECON 


18.  Program  TIDECON  synthesizes  harmonic  constituents  from  a  time 
series  of  hourly  tidal  elevation  data.  This  program  requires  the  following 
data: 

a.  Time  series  of  tidal  elevation  data  in  the  format  used  by  the 
National  Ocean  Service  (NOS)  (see  Table  B-4) . 

b.  Longitude  of  the  gage. 

£.  Constituent(s)  that  are  desired. 

4.  Starting  date  of  the  tide  data.  Starting  time  of  data  must  be 
at  midnight  (HR  0) . 

19.  Tide  data  must  be  free  of  gaps,  spikes,  and  other  errors  in  order 
to  compute  accurate  constituents.  No  error  correction  or  data  reconstruction 
features  exist  in  this  program.  Furthermore,  the  tidal  elevation  time-history 
data  set  length  required  varies  from  constituent  to  constituent.  A  minimum  of 
30  days  of  continuous  hourly  data  are  needed  to  resolve  lunar  constituents 
(for  example,  M2).  However,  some  longer  period  constituents  (which  usually 
have  a  relatively  small  effect  on  the  total  tidal  elevation)  may  require  as 
many  as  19  years  of  continuous  hourly  data  to  obtain  accurate  results.  Hence, 
the  user  should  plot  the  time-history  data  generated  using  the  computed 
constituents  to  check  the  accuracy  of  program  TIDECON  output.  (See  program 
HYDPLT  in  package  CMSPOST  (Appendix  C)  to  plot  time-history  data.) 

20.  Output  consists  of  four  files  containing:  (1)  original  gage  data, 
(2)  constituent  data,  (3)  synthesized  gage  data,  and  (4)  residual  difference 
between  original  and  synthesized  gage  data.  Items  (1),  (3),  and  (4)  are 
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produced  Co  check  Che  accuracy  of  Che  consCituents  generated  by  this  program. 
These  files  may  be  ploCted  using  program  HYDPLT  in  package  CMSPOST. 

Data  requirements 

21.  An  instruction  file  must  be  created  before  execution.  This  file 
must  contain  the  following  information: 

a.  Tide  gage  file  name. 

b.  Date  of  the  first  elevation  record  in  the  data  file. 

c.  Constituents  to  be  generated. 

d.  Gage  longitude. 

22.  This  information  is  listed  in  the  form  of  data  records  where  each 
record  must  start  with  an  identifier,  in  column  1.  Table  B-5  presents  the 
allowable  records,  with  an  explanation  of  each,  required  by  this  program. 
Furthermore ,  the  commands  must  be  entered  into  the  instruction  file  in  the 
order  shown  in  Table  B-5.  Required  records  are  indicated  by  "Type  [R]"  and 
must  be  contained  in  the  instruction  file.  Such  records  include:  FILES, 

TIME,  CNST,  and  LONG.  Optional  records  are  indicated  by  "Type  [0]”  and  are 
optionally  included  in  the  instruction  file.  Such  records  include  the  TITLE 
and  DEBUG  records. 

23.  Data  to  the  right  of  the  record  identifier  are  read  format -free. 
These  data  must  be  separated  by  at  least  one  blank  column  (commas  cannot  be 
used).  The  FILES  record  contains  the  name  of  the  file  containing  gage  data. 
The  TIMES  record  specifies  the  start  time  for  the  elevation  data  contained  in 
the  file  specified  on  the  FILES  record.  The  parameters  included  on  this 
record  are  the  year,  month,  and  day  at  the  start  of  the  elevation  data  set. 

24.  Constituents  selected  for  processing  are  specified  with  record 
CNST.  Constituents  are  designated  on  the  CNST  command  by  their  reference 
number  (see  Table  B-l)  rather  than  by  their  names.  However,  if  all  37  con¬ 
stituents  are  desired,  the  user  may  enter  "ALL"  instead  of  listing  all  of  the 
reference  numbers.  Also,  if  some  of  the  reference  numbers  are  consecutive, 
the  user  can  list  the  first  number,  immediately  followed  by  a  hyphen,  then  the 
last  reference  number  (e.g.,  5-9  would  generate  constituents  5  through  9  on 
Table  B-l).  Record  LONG  specifies  the  west  longitude  of  the  gage,  in  degrees 
relative  to  the  Greenwich  meridian.  The  user  may  optionally  select  a  title 
(record  TITLE)  to  be  used  for  plotting  results.  Record  DEBUG  can  be  included 
to  perform  error  processing. 
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NOS  Tidal  Elevation  Record  Format 
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Instruction  File  Commands  for  Prosrani  TIDECQN 
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25.  Time  series  input  data  must  be  in  the  format  used  by  the  NOS  Tidal 
Evaluation  Group  (Table  B-4).  The  following  requirements  must  also  be  met: 

a.  The  first  tide  record  must  begin  at  midnight  (HR  0)  of  the  date 
specified  in  the  instruction  file.  If  the  user's  data  begin  at 
a  time  other  than  midnight,  then  the  time  series  should  be 
truncated  to  begin  at  midnight  of  the  following  day. 

b.  Each  record  must  contain  12  hourly  values,  with  the  first 
record  starting  at  hour  0,  the  second  record  starting  at  hour 
13,  the  third  record  starting  at  hour  0  of  the  second  day,  etc. 

c.  Tidal  heights  are  entered  as  integers  and  measured  in 
hundredths  of  a  foot.  (For  example,  the  value  "1247" 
translates  to  12.47  ft.) 

26.  This  program  processes  only  the  elevation  data  listed  in  columns  33 
through  80  of  the  time  series  data  file.  Columns  1  through  32  are  for 
optional  documenting  of  the  data  set,  and  data  in  these  columns  are  not  used 
by  the  program. 

27.  The  following  example  illustrates  the  structure  of  an  instruction 

file: 


FILES 

MYDAT 

TIMES 

1987  2 

15 

LONG 

135.0 

CNST 

13  6- 

■8 

TITLE 

EXAMPLE 

INSTRUCTION  FILE 

28.  In  this  example,  tidal  elevation  time-history  data  have  a  starting 
date  of  15  February  1987.  The  starting  time,  specified  in  the  NOS  data  set, 
must  be  at  midnight  (0  hr).  The  time-history  data  will  be  analyzed  to  derive 
the  amplitudes  and  epochs  for  the  five  constituents  listed  in  command  CNST. 
These  constituents  are  M2,  N2 ,  01,  M6 ,  and  MK3  (see  Table  B-l). 

Program  execution 

29.  After  creating  and  saving  the  instruction  file,  enter  the  following 
interactive  commands  to  execute  the  program: 

h2crplcl : 1 a  r  r y $/u3/h2crplcO/ cma 

The  CMS  responds : 
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Return  for  more 


*  C  M  S  '  COMPONENTS  - 

*  Options: 

* 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid) 

* 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes 

*  numerical  models)  . . 

* 

*  CMSPOST  (Plots  and  lists  model  outputs)  - - 

* 

*  CMSUTIL  (Additional  “utility"  programs)  . 

* 

*  Exit  CMS  . - . 


To  enter  CMSUTIL,  the  user  enters  a  value  of  4: 


Enter  option  number  . - . . >  ;§ 


The  CMS  responds: 


************ 
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Return  for  more 

’  *  *  • 

*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 
********************************************************************* 


Options : 

On-Line  Help  . . 

Enter  CMSUTIL  Module 
Return  to  Main  Menu 


********************************************************************* 


Enter  option  number 


******************************************************************* 

*  CMSUTIL  MENU  * 

******************************************************************* 

*  * 

*  TIDEGEN  Generates  a  time  series  of  tidal  elevations  * 

*  from  harmonic  and  tidal  constituents.  - >  1  * 

*  * 

*  TIDECON  Synthesizes  harmonic  constituents  from  time  * 

*  series  of  hourly  tidal  elevation  data.  - >2  * 


******************************************************************* 
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To  execute  program  TIDECON,  the  user  enters  a  value  of  2: 

Enter  option  number  - - >  $ 

The  CMS  responds: 


TTTTTTT 

I 

DDDDD 

EEEEEE 

CCCC 

00 

N 

N 

: 

I 

D 

D 

:  E 

c  c 

0  0 

NN 

N 

T 

I 

D 

D 

SM: 

■m? 

0 

N  N 

N 

T 

I 

D 

D 

EEEE 

c 

0 

0 

N  N  N 

T 

. 

D 

D 

E 

c 

0 

0 

N 

N  N 

T 

I 

D 

D 

c  c 

0 

0 

N 

NN 

■  T  V:-: 

I 

DDDDD 

EEEEEE 

CCCC 

00 

N 

N 

Return  for  more _ 


Enter  the  name  of  the  instruction  file 

Again,  the  user  can  choose  any  meaningful  naming  convention  when  selecting 
filenames . 

Enter  the  name  of  the  input  file  containing  time  series  data 
Enter  the  name  of  the  time-history  and  constituent  output  file 
The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 
Request  5678 , larry  submitted  to  queue  prime. 


The  user  enters  3  to  terminate  the  CMSUTIL  session  and  return  to  the  main 
menu. 

Program  output 

30.  Program  TIDECON' s  output  file  may  be  printed  for  inspection  of 
values.  Output  files  containing  time-histories  of  tide  elevations  can  be  used 
as  direct  input  to  the  plotting  program  HYDPLT  in  package  CMSPOST.  The  actual 
tidal  constituents  are  output  in  the  same  file. 
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:********** 


*  CMSUTIL  MENU  * 

* 
* 
* 
* 
* 


TIDEGEN 


TIDECON 


Generates  a  time  series  of  tidal  elevations 
from  harmonic  and  shallow  water  tidal 
constituents.  . > 

Synthesizes  harmonic  constituents  from  time 
series  of  hourly  tidal  elevation  data.  - > 


* 
* 
* 
* 
* 

.1.  l ..  l. .  l. .  l.  l ..  l.  .  i ..  i. .  i. .  *  a  .1.  ■ . .  l. .  i— i. .  .  i  a . .  i . . ■ . _  1  - . i. .  1..1-.1- .1~_1 . . t . .1 . . i.. t. .  a.. i  .«.  1. .  i. .  i. .  i  .a  •  i.  « .  .  i. .  i . .  i  .  i. .  i. . « .  _  i  _  _i .  .1, .  i. .  i . .  a 


EXIT 
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Introduction 


1.  CMSPOST  is  the  post-processing  package  in  the  Coastal  Modeling 
System  (CMS)  for  displaying  output  generated  by  models,  CMSPOST' s  graphical 
and  tabular  output  will  help  the  user  in  analyzing  model  results.  Model 
output  is  directly  read  into  this  package;  however,  in  most  cases  an 
instruction  file  containing  information  to  generate  the  plots  must  be  created 
by  the  user.  CMSPOST  can  also  process  data  not  generated  by  the  models;  but 
data  must  be  in  the  format  required  by  the  programs.  The  types  of  graphics 
that  can  be  produced  are: 

a.  Time-histories  of  water  surface  elevations,  water  and  wind 
velocities,  and  pressure  at  discrete  locations. 

b.  Vector  maps,  or  "snapshots,"  of  water  or  wind  velocities  at  a 
specified  time  in  the  simulation. 

c.  Profile  plots  showing  the  spatial  distribution  of  a  variable. 

d.  Wave  ray  plots  for  displaying  RCPWAVE  output  only. 

In  addition,  model  SHALWV  has  its  own  graphics  option  (see  Chapter  7). 

2.  All  programs  are  written  in  FORTRAN  77,  and  graphics  are  produced 
using  DISSPLA™  software.  Graphic  output  structure  requires  use  of  Tektronix 
4014  or  compatible  terminals. 

3.  The  programs  contained  in  CMSPOST  are  described  in  Table  C-l.  Refer 
to  records  RECGAGE ,  RECSNAPS ,  PLOTREC,  XRECRANG ,  and  YRECRANG  in  the  model 
documentation  for  creating  and  saving  data  used  in  CMSPOST. 

Data  Requirements 

Instruction  file  for  time-historv  programs 

4.  The  instruction  file  contains  commands  describing  how  the  data 
set(s)  are  to  be  processed.  Each  line  in  the  file  must  begin  with  a  record 
identifier  that  signifies  an  operation.  The  record  identifier  must  begin  in 
column  1  of  the  line;  the  program  will  not  right- justify  these  variables.  The 
data  entered  after  the  record  identifier,  unless  otherwise  noted,  are  read 
free  format  and  must  be  separated  by  at  least  one  blank  column  (commas  can  not 
be  used).  All  instruction  file  commands  for  the  time-history  programs  are 
listed  in  Table  C-2. 
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Table  C-l 


Post-Processing  Programs 


Program 

DescriDtion 

Aoolicable  to 

HYDPLT 

Produces  time-series  plots  of  water  surface  fluct¬ 
uations,  wind  and  water  velocities,  pressure  head 
and  discharge. 

SPH,  WIFM , 
CLHYD 

HYDLST 

Prints  time -series  of  water  surface  fluctuations 
water  velocities,  wind  velocities,  and  angles, 
pressure  head,  and  water  discharge. 

SPH,  WIFM, 
CLHYD 

HYDADD 

Concatenates  time -history  records  from  successive 
runs  of  a  model  for  processing  by  HYDLST  or  HYDPLT. 

SPH,  WIFM, 
CLHYD 

SNAPVEC 

Produces  vector  plots  of  water  and  wind  velocity 
fields. 

SPH,  WIFM, 
CLHYD 

SNAPLST 

Prints  field  arrays  described  in  SNAPVEC.  Vectors 
may  be  printed  as  either  x-y  components  or  as 
magnitude  and  direction. 

SPH,  WIFM, 
CLHYD 

PROFPLT 

Profile  plot  of  specified  field  variable. 

SPH,  WIFM, 
CLHYD, 

RCPWAVE 

RAYPLT 

Wave  ray  plots  from  model  RCPWAVE. 

RCPWAVE 

5.  Programs  that  create  time-history  plots  and  tables  can  process  a 
maximum  of  four  separate  data  sets  simultaneously.  Furthermore,  data  from  one 
file  can  be  plotted  with  data  from  another  on  the  same  graph. 

6.  All  commands,  categorized  as  format  [F]  or  select  [S]  commands,  may 
appear  in  any  order.  Format  commands  refer  to  operations  that  modify  the 
default  parameters  controlling  the  format  of  the  plots  or  tables.  For 
example,  the  type  of  modifications  that  can  be  made  include  changing  axes 
titles,  or  the  minimum,  maximum,  and  increment  values  used  to  plot  the 
independent  variable. 

7.  Select  commands  are  used  to  select  the  data  set,  type  of  data,  and 
the  time-history  to  be  plotted  or  tabularized.  The  first  letter  in  the  record 
identifier  for  select  commands  represents  the  type  of  data  (e.g.,  T  -  water 
surface  level  data)  that  is  to  be  processed.  Immediately  adjacent  to  the 
record  identifier  is  a  qualifier  that  identifies  which  file  is  to  be  used. 
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This  qualifier  is  either  the  number  corresponding  to  the  order  in  which  the 
file  names  are  entered,  or  the  character  string  "ALL."  If  the  string  "ALL"  is 
used,  then  all  processing  procedures  selected  with  this  command  will  be 
performed  on  all  files. 

8.  Gage  numbers  are  listed  after  the  record  identifier  for  those  gages 
that  the  user  wishes  to  process.  If  the  gages  are  consecutive  in  value,  the 
user  can  list  the  first  and  last  gage  numbers,  separated  by  a  hyphen. 

9.  When  processing  more  than  one  file  simultaneously,  the  select 
commands  form  a  "plotting  matrix"  that  determines  the  contents  of  each  plot. 
One  plot  will  be  produced  for  each  column  in  the  matrix.  The  number  of  non¬ 
zero  entries  in  each  column  of  the  matrix  determine  the  number  of  lines  drawn 
on  each  plot.  The  nonzero  entries  are  the  gage  numbers  whose  time-histories 
are  to  be  plotted.  The  command  qualifiers,  which  define  the  matrix  rows, 
designate  the  file  containing  the  gage  data.  The  following  example 
illustrates  this  matrix  structure  for  files  AFILE,  BFILE,  CFILE,  and  DFILE: 


TGAG1  3 
TGAG2  0 
TGAG3  0 
TGAG4  0 

Plot  1 


0 

-  2 
0 

plot  r 


1-5 

1-5 

1-5 

Plots  3-7 


10.  A  total  of  seven  water  surface  elevation  plots  (or  tables)  will  be 
generated  from  the  four  files.  Command  qualifier  1  (in  command  TGAG1) 
corresponds  to  file  AFILE,  qualifier  2  corresponds  to  BFILE,  etc.  The  first 
plot  will  contain  the  time-history  of  gage  3  stored  in  file  AFILE.  (Zeros 
must  be  entered  for  null  gages.)  The  second  plot  will  contain  two  time- 
histories,  one  of  gage  4  in  file  BFILE  and  the  other  gage  2  in  CFILE.  The 
third  column  will  produce  five  plots.  The  third  plot  will  contain  the  time- 
histories  of  gage  1  from  each  of  the  four  files.  The  fourth  plot  will  contain 
time -histories  of  gage  2,  also  from  all  four  files,  and  so  forth,  with  the 
seventh  plot  being  time -histories  of  gage  5  from  all  four  files. 

Instruction  file  for  snapshot  programs 

11.  Instruction  file  requirements  for  the  snapshot  programs  are  similar 
to  those  required  by  the  time -history  programs: 

a.  Each  command  in  the  file  must  begin  with  a  record  identifier 
starting  in  column  1. 

b.  Format  and  select  commands  may  appear  in  any  order. 
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£.  Data  entered  after  the  record  Identifier  are  read  free- 
format. 

12.  In  contrast  to  the  time-history  programs,  the  snapshot  programs  can 
process  only  one  file  at  a  time.  All  snapshot  instruction  file  commands  are 
described  in  Table  C-3.  Those  applicable  to  each  program  are  listed  in  the 
program  descriptions. 
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Instruction  File  Commands  for  Snapshot  Plots 
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13.  Program  HYDPLT  is  a  general  purpose  program  for  plotting  time- 
history  records  generated  and  stored  by  the  models  contained  in  CMS.  The  CMS 
models  save  the  following  information  for  each  gage  specified  by  a  RECGAGE 
record:  water  surface  fluctuation,  x  and/or  y  water  velocity  components,  and 
x  and  y  wind  velocity  components.  Atmospheric  pressures  are  saved  if  SPH  is 
used  to  generate  the  wind  fields.  Discharges,  saved  using  a  XRECRANG  or 
YRECRANG  record  when  running  the  models,  are  also  stored  in  this  file. 

14.  A  maximum  of  four  time -series  data  files,  where  each  data  file  can 
contain  up  to  120  gages,  may  be  processed  simultaneously.  No  gage  can  contain 
more  than  1,000  sampling  points. 

15.  An  instruction  file  must  be  created  and  stored  before  execution  can 
begin.  Options  to  change  the  default  plotting  formats  are  included  in  this 
file.  The  following  instruction  commands,  which  were  described  in  Table  C-2 
are  valid  for  this  program: 


A  sample  instruction  file  for  program  HYDPLT  is  given  below: 


PFORM 

TITLE 

4 

CLHYD  SIMULATION  NO  1. 

TIDE  WITHOUT 

FEATHERING 

TAXIS 

TGAGl 

DEBUG 

-5.  5.  2.5 

1-2 

DEBUG 

TGAG 

VGAG 

WGAG 

RGAG 

REPRT 

TSPL 

VSPL 

WSPL 

RSPL 

PFORM 

TAXIS 

VAXIS 

WAXIS 

RAXIS 

TITLE 

TIMES 

PENUP 

XAXIS 

NHCPY 

TTITL 

TADJ 

VTITL 

WTITL 

RTITL 

This  file  is  used  in  the  following  example. 

To  invoke  program  HYDPLT,  the  user  enters  the  command: 


h2crplcl:larry$ 


(Ic  should  be  noted  that  user  entries  are  shown  as  shaded,  and  CMS  response 
"screens"  are  shaded  boxes.)  The  CMS  responds: 


W  E 

LCOME 

TO.. 

• 

xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

xxxxx 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

Return  for 

X 

more.  .  . 

XXXXX 

********************************************************************* 


*  CMS  COMPONENTS  * 

*  . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . -->  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - . >  3  * 

*  '  * 

*  CMSUTIL  (Additional  "utility"  programs)  . - . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 


********************************************************************* 


To  use  the  CMSPOST  programs,  the  user  responds  to  the  CMS  prompt  with  a  value 


Enter  option  number  . >  $ 


The  CMS  responds: 


cccc 

M 

M 

SSSS 

PPPPP 

00 

SSSS 

TTTTTTT 

c  c 

MM 

MM 

S  S 

P  P 

0  0 

s  s 

T 

c 

M  M  M  M 

S 

P  P 

0  0 

s 

T 

c 

M  M 

M 

SSSS 

PPPPP 

0  0 

SSSS 

T 

c 

M 

M 

S 

P 

0  0 

s 

T 

c  c 

M 

M 

s  s 

P 

0  0 

s  s 

T 

cccc 

M 

M 

SSSS 

P 

00 

SSSS 

T 

Return 

for  more. 

********************************************************************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . - . >  3  * 

*  •  * 


********************************************************************* 


Enter  option  number  . >  2 

The  CMS  responds : 
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CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  enters:  byd|4;t 


The  CMS  responds: 


H 

H 

Y  Y  DDDDD 

PPPPP 

L 

TTTTTTT 

H 

H 

Y  Y  D  D 

P  P 

L 

T 

H 

H 

Y  Y  D  D 

P  P 

L 

T 

HHHHHH 

Y  D  D 

PPPPP 

L 

T 

H 

H 

Y  D  D 

P 

L 

T 

H 

H 

Y  D  D 

P 

L 

T 

H 

H 

Y  DDDDD 

Return  for 

P 

more .  .  . 

LLLLLLL 

T 

Enter  the  name  of  the  instruction  file:  hydplt, ttts 
Valid  user  responses  are: 

TEK40  or  tek40  -  (hydrograph  file  will  be  plotted  on  TEKTRONIX 
4014  or  VT240  terminal) 

LASER  or  laser  -  (hydrograph  file  plotted  on  laser  printer) 
Enter  device  name  TEK40 

How  many  input  data  files  will  be  processed?  § 

***the  number  of  files  must  be  between  1  and  4 
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Do  you  want  to  reenter  the  number  of  files  to  be  processed? 
Enter  yes  or  no  to  continue  |j|| 

Enter  the  number  of  files  to  be  processed  | 

Enter  the  name  of  the  first  data  set: 

Enter  the  name  of  the  output  file: 


The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames. 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  simulation. 


The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 

Request  4359 . larry  submitted  to  queue: prime 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concantenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component.  A 
DISSPLA™  metfil  is  thus  produced.  To  plot  the  HYDPLT  metfil  on  a  Tektronix  or 
Tektronix  emulator,  the  user  types: 

/u3/h2crplt0/eoipidt 


and  the  plot  is  displayed,  as  shown  below: 


cuk  k  n  n  me  me 

_  t  it  u  liter  ME 


m 

Wi 

II 

■■ 
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mm 
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■■ 

■■ 

MM 
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m 

H 

m 

LI 

mm 

mil 

■i 

■il 

■11 
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Ml 

■M 

» 

■ 

■ 

1M 

11 

K 

M 

Wi  I 

m 

rji 

Ml 

■i 

Ml 

MM 

■n 

mtm 

M 

m 

■ 

■ 

ill 

Ml 

■i 

mm 

mu 

awe  m  m  <*»  me  me 
_  a  u  i»  warn  me 


roe,  HUB 


OHIO  SlMULflTION  MO.  It  TIDE  WITHOUT  FEATHOUN6 


Figure  C-l.  Sample  water  surface  elevation  HYDPLT 


Similarly,  a  time-history  of  velocity  data  can  be  generated  using  the 
instruction  file  below: 


PFORM  U 

TITLE  CLHYD  SIMULATION  NO.  1:  TIDE  WITHOUT  FEATHERING 
VAXIS  6.0  2.0 
VGAG1  1-2 
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•  «  m  n  m  a 

Tire,  KUO 

*  i 

m  a  M  m 

tUC,  KMQ 

curve  m  hv 

_  i  it 

!  vw  M  me 

is  inti  me 

curve  m 
_  2 

hw  vo*  me  wre 
«  »  ocem  me 

■■■■■ 

■■■■■ 

■■Mil 

iniBisal 

CUM)  SIMULATION  NO.  1>  TI0E  WITHOUT  FOmCRINB 


Figure  C-2.  Sample  velocity  HYDPLT 

In  the  following  example,  time -histories  of  wind  and  pressure  for  an  SPH 
simulation  are  displayed.  The  instruction  file  for  this  plot  was  simply: 


WGAG1 

WAXIS  120  20  2.1 
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Tool  No.  I'  SPH  5 lor. 


C-3.  Sample  wind  and  pressure  HYDPLT 
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Program  HYDLST 


16.  Program  HYDLST  is  a  general  purpose  program  for  printing  gage  time- 
history  records  generated  and  stored  by  the  models  contained  in  CMS.  The  CMS 
models  save  uhe  following  information  for  each  gage  specified  by  a  RECGAGE 
record:  water  surface  elevations,  x  and/or  y  water  velocity  components,  and  x 
and  y  wind  velocity  components.  Atmospheric  pressures  are  saved  if  SPH  is 
used  to  generate  the  wind  fields.  Discharges,  saved  using  an  XRECRANG  or 
YRECRANG  record  when  running  the  models,  are  also  stored  in  this  file. 

17.  A  maximum  of  four  time-history  data  files  may  be  processed 
simultaneously  by  program  HYDLST,  with  each  data  file  containing  up  to  120 
gages.  No  gage  can  contain  more  than  1,000  sampling  points. 

18.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  formats  are  included  in  this  file.  The 
following  instruction  commands,  which  were  described  in  Table  C-2  are  valid 
for  this  program: 


TIMES 

TGAG_ 

TADJ_ 

VGAG_ 

WGAG_ 

RGAG 


A  sample  instruction  file  for  program  HYDLST  is  given  below: 


TGAG1  1-2 
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19.  To  Invoke  program  HYDLST,  the  user  enters  the  command: 
h2crplcl : larry$ 


The  CMS  responds : 


WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

X 

XXXXX 

Return  for 

more . . . 

********************************************************************* 
*  CMS  COMPONENTS  * 


*  Options :  * 

★  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1* 

*  *■  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - - - - >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  — . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 

********************************************************************* 
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cccc 

M 

M 

SSSS 

ppppp 

00 

ssss 

c 

MM 

MM 

S  S 

p  p 

0 

0 

s  s 

T 

M  M  M  M 

s 

p  p 

0 

0 

s 

T 

M 

M  M 

ssss 

ppppp 

0 

0 

ssss 

T 

M 

M 

s 

p 

0 

0 

s 

T 

:  c 

M 

M 

s  s 

p 

0 

0 

s  s 

T 

cccc 

M 

M 

ssss 

p 

00 

ssss 

T 

Return  for  more... 


********************************************************************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options:  * 

*  * 

*  On-Line  Help  . - . >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . - . >  3  * 

*  * 


********************************************************************* 


Enter  option  number  . - . >  2 

The  CMS  responds : 
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CMS POST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concantenates  two  successive  time  series  data 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user 

The  CMS 


enters:  hydlst 
responds : 


H  H 

Y  Y 

DDDDD 

L 

SSSSS 

TTTTTTT 

H  H 

Y  Y 

D  D 

L 

S 

T 

H  H 

Y  Y 

D  D 

L 

S 

T 

HHHHHH 

Y 

D  D 

L 

SSSS 

T 

H  H 

Y 

D  D 

L 

S 

T 

H  H 

Y 

D  D 

L 

S 

T 

H  H 

Y 

DDDDD 

LLLLLLL 

SSSSS 

T 

Return  for 

more .  . 

Enter  the  name  of  the  instruction  file:  hydlsttias 

How  many  input  data  files  will  be  processed?  5 
***the  number  of  files  must  be  between  number  1  and  4*** 

Do  you  want  to  reenter  the  number  of  files  to  be  processed? 

Enter  yes  or  no  to  continue  yes 

Enter  the  number  of  files  to  be  processed 

Enter  the  name  of  the  first  data  set:  hydiftt*! 

Enter  name  of  output  file  hydlst  .Ottt 

Th-*  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames 
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For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  simulation. 


The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 


Request  4343. lurry  submitted  to  queue ‘.prime 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concantenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CKSPOST  component.  To  list 
the  HYDLST  results,  the  user  types: 


pg  hydlst .out 


The  system  responds: 
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0.00 

0.86E+05 

360.000 

SECONDS 

ELEVATION  LISTING 


FILE  I  TITLE:  MOCK-UP  TEST 


FILE  1 

GAGE  I 

GAGE  2 

X  Y 

X  Y 

LOCATION 

3  13 

11  13 

TIME 

ELEVATION 

ELEVATION 

SECONDS 

FEET 

FEET 

0.00 

0.500 

0.570 

360.00 

0.500 

0.570 

720.00 

0.500 

0.570 

10440.00 

0.500 

0.570 

10800.00 

0.613 

0.570 

11160.00 

0.900 

0.570 

11520.00 

1.11 

0.570 

11880.00 

1.35 

0.629 

12240.00 

1.49 

0.687 

12600.00 

1.62 

0.685 

12960.00 

1.80 

0.724 

13320.00 

2.02 

0.771 

13680.00 

2.20 

0.799 

14040 . 00 

2.30 

1.03 

14400.00 

2.42 

1.26 

14760.00 

2.58 

1.48 

15120.00 

2.67 

1.72 

15480.00 

2.86 

1.97 

15840.00 

3.09 

2.22 

16200.00 

3.16 

2.47 

16560.00 

3.17 

2.74 

FILE  1 
FILE  TITLE 
MOCK-UP  TEST 

PROVISIONAL  STARTING  TIME: 
PROVISIONAL  ENDING  TIME: 
DATA  INTERVAL: 

TIME  UNIT: 


C-26 


Program  HYP ADD 


20.  Program  HYDADD  concatenates  two  time -history  data  files  from 
successive  simulations  of  the  long-wave  models.  Program  HYDADD  is  typically 
applied  to  a  WIFM  "cold  start"  hydrofile  and  a  WIFM  "hot  start"  hydrofile  to 
make  one  combined  hydrofile.  No  instruction  file  is  required.  However,  the 
following  requirements  must  be  met: 

a.  The  two  files  must  be  sequential  in  time. 

b.  All  gages  and  ranges  must  be  identical,  in  number  and  sequence, 
in  the  two  files. 

c.  Grid  rotation  must  be  identical  in  the  two  files. 

The  program  will  check  the  above  requirements  and  will  terminate  with  an 
appropriate  error  message  if  any  violations  are  detected. 

21.  To  invoke  program  HYDADD,  the  user  enters  the  command: 

h2crplcl:larry$  /u3 /h2crplc0/cms 


The  CMS  responds : 


W  E 

LCOME 

TO.. 

- 

xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

xxxxx 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

xxxxx 

X 

X 

XXXXX 

Return  for 

more .  . . 
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*  CMS  COMPONENTS  * 

*  . - . * 

*  Options:  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1* 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - >  2  * 

■k  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 


Enter  option  number 


>  | 


The  CMS  responds: 


CCCC 

M 

M 

ssss 

ppppp 

00 

ssss 

TTTTTTT 

C  C 

MM 

MM 

s  s 

p  p 

0 

0 

s  s 

T 

c 

M  M  M  M 

s 

p  p 

0 

0 

s 

T 

c 

M 

M  M 

ssss 

ppppp 

0 

0 

ssss 

T 

c 

M 

M 

s 

p 

0 

0 

s 

T 

c  c 

M 

M 

s  s 

p 

0 

0 

s  s 

T 

CCCC 

M 

M 

ssss 

p 

00 

ssss 

T 

Return  for  more... 
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CO  CO 


af  ^X  wC  wt  PC  X  <rt  ft  wC  JC^fCvC  wC  fC  4pf  af wC^fCwCwC  <rf  *fC*K <PP#f^Mf  ^T  &CjCFC*C*fClr[*C'rt  wswCifC  &CwC<JC  wt^rCTCrC^K  &tTn?wCwC^nFTwt*9C*X*X7KlK  S» 


* 

* 

* 


USING  THE  COASTAL  MOLL  MNG  SYSTEM 


* 

* 

* 


**************************************  *** i *************************** 


* 

* 

* 

* 

* 

* 

* 

* 

* 


Options : 

On-Line  Help  - - - - - > 

Enter  CMSPOST  Module  . > 

Return  to  Main  Menu  - - - - - . . > 


* 
* 
* 

1  * 
* 

2  * 
* 

3  * 

* 

,-***************************** 


Enter  option  number 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  enters:  hydftdd 
The  CMS  responds : 


H 

H 

Y  Y 

DDODD 

AA 

DDDDD 

DDDDD 

H 

H 

Y  Y 

D 

D 

A 

A 

D  D 

D  D 

H 

H 

Y  Y 

D 

0 

A 

A 

D  D 

D  D 

HHHHHH 

Y 

D 

D 

AAAAAA 

D  D 

D  D 

H 

H 

Y 

D 

D 

A 

A 

D  D 

D  D 

H 

H 

Y 

D 

D 

A 

A 

D  D 

D  D 

H 

H 

Y 

DDDDD 

A 

A 

DDDDD 

DDDDD 

Return  for 

more.  . 

• 

Enter  the  name  of 
Enter  the  name  of 
Enter  the  name  of 


the  first  data  iet: 
the  second  data  set 
combined  data  set: 


flUl.-fcyd 
flleS.hyd 
file com, hy 3 


The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames. 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  file. 


The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 


Request  4243 . lerry  submitted  to  queue : prime 


The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component. 


The  individual  files  and  combined  files  are  as  follows: 


MOCK-UP  TEST 

11  0 

OOOE+OO  1  1 

1  0 

0 

SECONDS  FEET 

FPS 

FPS 

FEETH20  CFS 

0.00 

360.00  720.00 

1080.00 

1660.00 

1800.00 

2160.00 

2520.00 

2880.00 

3260.00  3600.00 

TGAGE  1 

3  13GAGE  1 

2  13S 

0.500 

0.500  0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500  0.500 

VGAGE  1 

3  13GAGE  1 

2.  13$ 

-0.120 

-0.65*  -0.218 

-0.237 

-0.277 

-0.276 

-0.230 

-0  113 

-0.131 

-0.196  -0.096 
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MOCK-UP  TEST 

8  O.OOOE+OO  11100 

SECONDS  FEET  FFS  FPS  FEETH20  CFS 
3600.00  3960.00  6320.00  6680.00  5060.00  5600.00  5760.00 

TGAGE  1  3  13GAGE  1  2  13$ 

01.500  01.500  01.500  01.500  01.500  01.500 

01.500 

VCAGE  1  3  13GAGE  1  2  13$ 


-1.120  -1.656  -1.218  -1.237  -1.277  -1.276  -1.230 


6120.00 

01.500 

-1.113 


MOCK-UP  TEST 

18  C 

000  1  1 

1  0 

0 

SECONDS  FEET 

FPS 

F 

0.00 

360.00  720.00 

1080.00 

1660.00 

1800.00 

2160.00 

2520.00 

2880. CO 

3260.00  3600.00 

3960.00 

6320.00 

6680.00 

5060.00 

5600.00 

5760.00 

6120.00 

TGAGE  1 

3  13GAGE  1 

2  13$ 

0.500 

0.500  0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500  1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

VGAGE  1 

3  13GAGE  1 

2  13$ 

i 
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Program  SNAPVEC 


22.  Program  SNAPVEC  produces  vector  plots  of  water  and  wind  velocities. 
A  maximum  of  100  snapshots  can  be  stored  in  the  data  file.  An  instruction 
file  must  be  created  before  execution  can  begin.  Options  to  change  the 
default  plotting  formats  are  included  in  this  file.  The  following  instruction 
commands ,  which  are  described  in  Table  C-3,  are  valid  for  this  program: 


DEBUG 

VWIND0 

WWINDO 

N0AVE 

VSCALE 

WSCALE 

TIMES 

TWIND0 

PWINDO 

TITLE 

GAGLOC 

A  sample  instruction  file  for  program  SNAPVEC  is  given  below: 


TIMES  LAST 
WWINDOl  1  26  1  24 
WSCALE1  60.0  0.5 


23.  To  invoke  program  SNAPVEC,  the  user  enters  the  command: 


h2crplcl : larry$  /u3/h2crplc0/cms 


The  CMS  responds : 
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W  E 

L  C  0  M  E 

TO.. 

• 

xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more . . . 

********************************************************************* 


*  CMS  COMPONENTS  * 

*  . - . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 


********************************************************************* 


Enter  option  number  . >  $ 

The  CMS  responds: 
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M 

SSSS 

P 

00 
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Return 

for  more . 

•  « 

A******************************************************************** 
*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

*************************************************** ****************** 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 


On-Line  Help  . 

Enter  CMSPOST  Module 


*  Return  to  Main  Menu  . >  3  * 

*  * 
********************************************************************* 


Enter  option  number 


The  CMS  responds : 
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CMS POST 

HYDPLT: 

Generates  plots  of  time  series  output 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD: 

Concatenates  two  successive  time  series 

SNAPVEC: 

Generates  vector  plots  of  model  output 

SNAPLST : 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT: 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT : 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  CMSPOST  session 

The  user  enters:  |||ij|||ii| 
The  system  responds: 


SSSSS 

N 

N 

AA 

PPPPP 

V  V 

EEEEEE 

CCCC 

S 

NN 

N 

A  A 

P  P 

V  V 

E 
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S 

N  N 

N 

A 

A 
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V  V 
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AAAAAAAA 
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V  V 
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S 
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A 

A 

P 

V  V 

E 

C 

S 

N 

NN 

A 

A 

P 

V  V 

E 

C 

SSSSS 

N 

N 

A  A 

Return 

P 

for  more. 

V 

EEEEEE 

CCCC 

Enter  the  name  of  the  instruction  file:  snapvec ; in* 

Valid  user  responses  are: 

TEK40  or  tek40  -  hydrograph  file  will  be  plotted  on  TEKTRONIX  4014 
or  VT240  terminal 

LASER  or  laser  -  if  you  want  laser  output  here  at  CERC 
Enter  device  name  lillli 

Enter  name  of  input  file  containing  snapshots  data  that  were  generated  by 
WIFM,  CLHYD,  SPH,  or  other  model 

Enter  name  of  output  data  set  ittapstiot . out 
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The  system  responds: 


STOP 

CP :0.002s,  Vallclock :0.038s,  0.8%  of  6 -CPU 

Machine 


The  CMS  responds: 


CMSPOST 

HYDPLT: 

Generates  plots  of  time  series  output 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD: 

Concatenates  two  successive  time  series 

SNAPVEC: 

Generates  vector  plots  of  model  output 

SNAPLST: 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT : 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT : 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component. 

To  plot  the  SNAPVEC  file  on  the  laser  printer,  the  user  transfers  the  file  to 
the  VAX  3300  using  the  ftp  command  (see  Chapter  2)  and  types: 

lassr  std00001.dat 

A  typical  SNAPVEC  plot  is  shown  below: 
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LENGTHS  60.00 


KNOTS 


Sample  wind  velocity  (SNAPVEC)  plot 


24.  Program  SNAPLST  produces  printouts  of  field  array  variables.  These 
variables  are  total  water  depth,  water  surface  elevation,  water  velocities, 
wind  velocities,  and  atmospheric  pressure.  Water  and  wind  velocities  may  be 
printed  as  x  and  y  components,  or  as  magnitude  and  direction.  Atmospheric 
pressures  are  printed  if  SPH  is  used,  either  as  a  stand-alone  model  or  as  a 
component  of  WIFM,  to  generate  the  wind  fields.  A  maximum  of  100  snapshots 
can  be  stored  in  the  data  file. 

25.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  printing  formats  are  included  in  this  file.  The 
following  instructions  commands,  which  are  described  in  Table  C-3,  are  valid 
for  this  program: 


DEBUG 

TSAMPL 

VSAMPL 

WSAMPL 

PSAMPL 

TIMES 

TFORMT 

VFORMT 

WFORMT 

PFORMT 

VPOLAR 

WPOLAR 

A  sample  instruction  file  for  program  SNAPLST  is  given  below: 


TIMES  1 
TF0RMT1  1514 
TSAMPL1  1  1 


26.  To  invoke  program  SNAPLST,  the  user  enters  the  command: 
h2crplcl : larry$  /u3/h2crplc0/c»s 


The  CMS  responds: 


WELCOME  TO 


xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

xxxxx 

Return  for  more... 


********************************************************************* 


*  CMS  COMPONENTS  * 

*  . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  - >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . . . >  2  * 

*  * 

*  CMS POST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

★  * 

*  Exit  CMS  . >  e  * 


********************************************************************* 


Enter  option  number  - - >  $ 

The  CMS  responds: 
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00 
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Return 

for  more. 

,  , 

********************************************************************* 


* 

* 

* 


USING  THE  COASTAL  MODELING  SYSTEM 


* 

* 

* 


********************************************************************* 


* 

* 

* 

* 

* 

* 

* 

* 

* 


Options : 

On-Line  Help  - - - -->  I 

Enter  CMSPOST  Module  . >  2 

Return  to  Main  Menu  - - - - - -->  3 


* 

* 

* 

* 

* 

* 

* 

* 

*■ 


********************************************************************* 


Enter  option  number  . -->  2 

The  CMS  responds : 


CMSPOST 

HYDPLT 

Generates  lists  of  time  sereis  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 
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The  user  enters: 


Mill 


The  system  responds: 


sssss 
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sssss 
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Return 

P 

for  more 

T.T.T.T.T.T.T. 

sssss 

T 

Enter  the  name  of  the  instruction  file: 

Enter  the  name  of  the  input  data  set:  $n*J)lst«l 
Enter  the  name  of  the  output  data  set  stMplst.OUC 
The  system  responds: 


STOP 

CP:002s ,  Wallclock:0: 105s ,  0.3%  of  6-CPU 

Machine 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMS POST  component. 
To  display  the  output  file,  the  user  enters: 

ppappigpii 


and  the  system  responds: 


MOCK  UP  TEST 

SURFACE  ELEVATIONS 

(FEET 

) 

SNAPSHOT  TIME 

-  lhrs 

OMIN 

OSEC 

X-  1 

2 

3 

4 

5 

mm 

4  7.13 

7.25 

7.22 

7.29 

7.44 

3  7.13 

7.21 

7.20 

7.29 

7.48 

2  7.13 

7.16 

7.09 

7.13 

7.24 

1  7.13 

7.13 

7.13 

7.13 

7.13 
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Program  RAYPLT 


27 .  Program  RAYPLT  is  a  wave  ray  plotting  program  specific  to  model 
RCPWAVE  output  only.  RCPWAVE  saves  wave  angle  data  for  each  grid  cell  if  a 
PLOTREC  record  is  contained  in  the  RCPWAVE  input  file.  The  wave  angle 
information  is  used  to  generate  a  wave  ray  plot  for  each  wave  condition 
simulated  by  RCPWAVE. 

28.  An  instruction  file  must  be  created  and  stored  before  execution  can 
begin.  Options  to  change  the  default  plotting  formats  are  included  in  this 
file.  The  following  instruction  commands,  which  are  described  in  Table  C-4, 
are  valid  for  this  program: 


TITLE 

RATIO 

ROTAN 

DEBUG 

COAST 

DUNIT 

XYINC 

A  sample  instruction  file  for  program  RAYPLT  is  given  below: 


TITLE 

DUCK,  NC 

ROTAN 

0 

COAST 

E 

DUNIT 

m 

XYINC 

12  24 

RATIO 

1  4 

DEBUG 

29.  To  invoke  program  RAYPLT,  the  user  enters  the  command: 


h2crplcl : larry$  /u3/h2crplcO/cas 
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The  CMS  responds : 

WELCOME 

T  0  , 

•  • 

XXXXX  X 

X 

XXXXX 

X 

X  XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X 

X  X 

X 

X  X 

XXXXX  X 

X 

XXXXX 

Return  for 

more .  . 

• 

********************************************************************* 

*  CMS  COMPONENTS  * 

*  . * 

*  Options:  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . >  2  * 

*  * 

*  CMS POST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  Exit  CMS  . .  e  * 

********************.:************************************************ 


*  CMS POST  (Plots  and  lists  model  outputs) 

* 

*  CMSUTIL  (Additional  "utility"  programs) 
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00 
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Return 

for  more. 

********************************************************************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options:  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . >  3  * 

*  * 


********************************************************************* 


Enter  option  number  . >  2 


The  CMS  responds: 
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CMS POST 

HYDPLT 

Generates  lists  of  time  serels  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  enters :  jjjiiiii 

The  system  responds: 


Enter  the  name  of  the  instruction  file:  vaypltvto* 

Enter  the  name  of  the  shoreline  file:  rayplt.shl 
Enter  the  name  of  the  wave  angle  file:  cayplt.ang 
Valid  user  responses  are: 

TEK40  or  tek40  -  (hydrograph  file  will  be  plotted  on  TEKTRONIX 
4014  or  VT240  terminal) 

LASER  or  laser  -  (hydrograph  file  plotted  on  laser  printer) 
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PPPPP 
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TTTTTTT 
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A  A  Y  Y 
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RRRRR 

AAAAAAAA  Y 

PPPPP 
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R  R 

A  A  Y 
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R 

A  A  Y 

P 
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A  A  Y 

Return  for 

P 

more.  .  . 

LLLLLL 

T 

Enter  device  name  TEK40 


Enter  name  of  output  data  file:  kz  -.fS4t 

The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 


STOP 

CP  :002s,  Wallclock: 0:105s,  0.3%  of  6-CPU 

Machine 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component.  To  plot 
the  RAYPLT  metfil  on  a  Tektronix  or  Tektronix  emulator,  the  user  types: 


/u3/h2crpic0/cmsplot 


and  the  plots 


are  displayed, 


as  shown  below: 


C-48 


Program  PROFPLT 


30.  Program  PROFPLT  is  a  general  purpose  program  for  generating  profile 
plots  of  data  produced  by  the  models  in  CHS.  Field  arrays,  such  as 
bathymetry,  water  surface  level,  wave  height,  magnitude  of  water  velocity,  and 
magnitude  of  wind  velocity,  can  be:  (a)  saved  by  the  models  (using  RECSNAPS), 
or  (b)  read  directly  from  the  model  input  file  (i.e.,  BATHSPEC)  for  use  by 
PROFPLT.  A  one -dimensional  "line"  from  the  array  is  plotted  in  profile  form 
to  show  the  distribution  of  the  variable  along  the  selected  "transect."  For 
example,  if  a  mound  exists  in  a  given  study  area,  one  could  select  a  transect 
through  the  mound,  and  plot  the  bathymetry  and  wave  height  over  the  mound. 

31.  A  maximum  of  100  profiles  can  be  processed  during  one  PROFPLT 
session.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  plotting  formats  are  included  in  this  file.  The 
following  instruction  commands,  which  are  decribed  in  Table  C-5,  are  valid  for 
this  program: 


DEBUG 

TITLE 

YAXIS 

TRANS 

LINE_ 

BATHY 

CURV2 

TIMES 


A  sample  instruction  file  for  program  PROFPLT  is  given  below: 


TRANS  1 

LINE1  1  20  27  27 
BATHY 

YAXIS  DEPTH,  meters 
DEBUG 

TITLE  PROFPLT  EXAMPLE 
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Instruction  File  Commands  for  Wave  Rav  Plots 
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